Início Rápido do PanÐá Zap: Envie sua Primeira Mensagem em Minutos

Siga estes cinco passos para sair de uma conta PanÐá Zap recém-criada até enviar sua primeira mensagem de WhatsApp pela API.

Entre no seu painel

Abra a URL do seu painel PanÐá Zap em um navegador e faça login com suas credenciais. Se você acabou de criar sua conta, verifique sua caixa de entrada em busca do e-mail de boas-vindas com o link de acesso.Depois de entrar, você chegará ao Dashboard, onde é possível ver a atividade de todos os seus canais conectados.

Conecte um canal do WhatsApp

Vá em Configurações → Canais e clique em + Novo Canal, depois selecione WhatsApp.O PanÐá Zap suporta dois modos de conexão:

Modo	Melhor para
QR Code	Configuração rápida usando uma conta do WhatsApp já existente no seu celular. Escaneie o QR Code exibido no painel com o aplicativo do WhatsApp para vincular o número instantaneamente.
API Oficial do WhatsApp (WABA)	Configuração de nível de produção, compatível com as políticas, via uma Conta Comercial aprovada pela Meta. Requer um Gerenciador de Negócios do Facebook verificado e um número de telefone aprovado.

Escolha o modo mais adequado ao seu caso de uso, preencha as etapas na tela e aguarde até que o status do canal exiba Conectado.

Crie uma chave de API

Vá em Configurações → API e clique em + Nova API.Dê um nome descritivo à chave (por exemplo, minha-primeira-integracao) e confirme. O PanÐá Zap exibirá dois valores — copie-os agora, pois o token Bearer é mostrado apenas uma vez:

Valor	Onde você vai usá-lo
Token Bearer	Cabeçalho `Authorization` em cada requisição
ID da API	Parte da URL da requisição

Sua URL base para todas as chamadas de API é:

https://{BaseUrl}/v2/api/external/{ApiID}/

Substitua {BaseUrl} pelo domínio do seu painel e {ApiID} pelo ID da API que você acabou de copiar.

Envie sua primeira mensagem

Com suas credenciais em mãos, faça a seguinte requisição para enviar uma mensagem de texto a um número do WhatsApp.

Para canais de API Oficial do WhatsApp (WABA), você deve usar um template de mensagem aprovado pela Meta para iniciar uma nova conversa. O campo body usado no exemplo abaixo serve para enviar respostas em texto livre dentro de uma janela ativa de 24 horas (ou seja, depois que o contato falou com você primeiro). Se você estiver usando um canal por QR Code, o campo body funciona para mensagens de saída sem restrição.

curl --request POST \
  --url "https://{BaseUrl}/v2/api/external/{ApiID}" \
  --header "Authorization: Bearer {BearerToken}" \
  --header "Content-Type: application/json" \
  --data '{
    "body": "Olá! Sua primeira mensagem do PanÐá Zap.",
    "number": "5511999999999",
    "externalKey": "primeira-mensagem-001"
  }'

{
  "body": "Olá! Sua primeira mensagem do PanÐá Zap.",
  "number": "5511999999999",
  "externalKey": "primeira-mensagem-001"
}

Campos da requisição

Campo	Tipo	Descrição
`body`	string	O conteúdo de texto da mensagem.
`number`	string	Número de telefone de destino no formato E.164, sem o sinal `+` (por exemplo, `5511999999999` para um número brasileiro).
`externalKey`	string	Uma chave de idempotência única que você gera para cada envio. Nunca reutilize o mesmo valor para mensagens diferentes — o PanÐá Zap usa essa chave para evitar envios duplicados acidentais.

Uma resposta bem-sucedida se parece com isto:

Resposta

{
  "success": true,
  "data": {
    "message": "Message sent successfully",
    "ticketId": 123
  }
}

Salve o ticketId retornado na resposta — é o identificador único desta conversa e é necessário para chamadas de API seguintes, como enviar mensagens de acompanhamento ou atualizar o status do ticket.

Confira a mensagem na sua caixa de entrada

Volte ao seu painel e abra a tela de Caixa de Entrada. Você deverá ver uma nova conversa (ticket) criada para o número que você mandou mensagem, com a mensagem enviada visível na conversa.A partir daqui você pode responder manualmente, atribuir o ticket a um membro da equipe ou continuar automatizando a conversa pela API usando o ticketId recebido.🎉 Prontinho! Você conectou um canal, gerou uma chave de API e enviou sua primeira mensagem com o PanÐá Zap.

Primeiros Passos

Canais e Equipes

Atendimento e CRM

Automação

Análises e Configurações

Início Rápido do PanÐá Zap: Envie sua Primeira Mensagem em Minutos