1
Entre no seu painel
Abra o endereço do seu painel PanÐá Zap em um navegador e faça login com seu e-mail e senha. Se um administrador cadastrou você com convite por e-mail, use primeiro o link do convite para definir a sua senha.Depois de entrar, Administradores e Supervisores chegam à página inicial (Início) e Atendentes vão direto para Atendimentos. Para o Administrador, a página inicial mostra o guia Primeiros passos (Conectar um canal, Criar uma fila, Convidar sua equipe e Iniciar a primeira conversa), que some sozinho quando tudo estiver concluído. As métricas dos atendimentos ficam em Dashboard, no grupo Principal do menu lateral.
2
Conecte um canal do WhatsApp
No menu lateral, em Administração, clique em Canais e depois em Adicionar Canal. Na janela Novo Canal, escolha o Tipo de Canal: as conexões por QR Code ficam no grupo WhatsApp Não Oficiais e a API oficial fica no grupo META (Oficial) (por exemplo, WhatsApp Oficial ou WABA). Os tipos exibidos dependem do que está liberado para a sua conta.O PanÐá Zap suporta dois modos de conexão:
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.
3
Crie uma chave de API
No menu lateral, em Configuração, clique em API e depois em Nova API.Preencha o Nome (por exemplo, O
minha-primeira-integracao), selecione em Sessão o canal que fará os envios (a sessão não pode ser alterada depois) e clique em Salvar. O PanÐá Zap abre uma janela com o token gerado: clique em Copiar agora e guarde o token em local seguro, pois ele é exibido apenas uma vez (depois, o cartão da API mostra só o Prefixo do token; se perder o token, use Gerar novo token).A URL de integração segue o formato:
{BaseUrl} é o endereço do servidor da API, que não é o mesmo endereço do painel. Por isso, copie sempre a URL de integração exibida no cartão da API em vez de montar o endereço à mão.4
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.Campos da requisiçãoSalve o
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.Uma resposta bem-sucedida se parece com isto:
Resposta
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.5
Confira a mensagem na sua caixa de entrada
Volte ao painel e, no menu lateral, em Atendimento, abra Atendimentos. Você deverá ver o atendimento (ticket) criado para o número que recebeu a mensagem, com a mensagem enviada visível na conversa.A partir daqui você pode responder manualmente, usar Transferir para passar o atendimento a outra fila ou atendente, 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.
