Webhook de envio de mensagens por Whatsapp via Sak

Introdução

Seja bem-vindo(a).

Através de um endpoint é possível enviar mensagens por Whatsapp via Sak através de webhooks.

Endpoint Webhook

Cada usuário tem a sua URL de webhook e um token, que podem ser obtidos na página de integrações em "Funcionalidades" > "Webhook de envio de mensagens". Um novo token é gerado toda vez que a integração é feita. Então sempre que reativar a integração atualize o token na sua plataforma.

Exemplo de URL: https://app.sak.com.br/Webhook/get/sendmessage/******/apps/send

Exemplo de token: 1c4d************************4c99

Integração dos dados

Segue o formato (JSON) de envio dos dados para o endpoint que deve ser seguido.

Formato para o envio de mensagem
{ "token":"1c4d************************4c99", "email":"email@site.com.br", "subject":"Assunto do e-mail.", "phone":"+5599912341234", "name":"John Doe", "message":"Essa é uma mensagem customizada.", "balancer":3 }
Descrição dos dados
POST https://app.sak.com.br/Webhook/get/sendmessage/******/apps/send

Parâmetro Tipo Obrigatório Descrição
token string sim Token fornecido na ativação da funcionalidade
email string não E-mail do contato que receberá a mensagem
subject string não Assunto do e-mail
phone string sim Telefone do contato que receberá a mensagem
name string sim Nome do usuário que receberá a mensagem
message string sim Mensagem que será enviada
balancer int não Id do balanceador responsável pelo envio, caso queira definir envios entre diferentes números de Whatsapp. Saiba mais sobre balanceadores de envios.

Visualização dos contatos e envios

Os contatos serão salvos como leads no Sak, o que permite visualizar a quantidade de envios por contato na página de Leads. Um lead é marcado como convertido quando entra um pedido com seu contato. Para visualizar leads convertidos, clique em "Mostrar convertidos" na página de leads.


Mensagem para envio dos webhooks

Uma mensagem de lead chamada "Mensagem para o webhook de envios" será criada com a tag [mensagem_customizada_webhook]. Não exclua essa mensagem e não exclua a tag.


Teste de webhooks

Pode demorar alguns minutos para que os webhooks enviados sejam tratados e as mensagens enviadas. Para testar o envio de webhooks, é possível utilizar o endpoint de testes para verificar se os dados estão corretos. Nenhuma mensagem será enviada.

URL de testes: https://app.sak.com.br/testeWebhooks/testeEnvioMensagensWebhook


Validação da mensagem

Envie um webhook com os dados para o endpoint abaixo. O conteúdo da mensagem será verificado. Caso o conteúdo não seja aceito, edite-o e tente novamente. Caso a mensagem reprovada seja enviada via endpoint principal, sua mensagem cairá em moderação e seus envios serao desabilitados temporariamente.

URL de validação: https://app.sak.com.br/testeWebhooks/validarMensagensWebhook