Seja bem-vindo(a).
Através de um endpoint é possível enviar mensagens por Whatsapp via Sak através de webhooks.
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
Segue o formato (JSON) de envio dos dados para o endpoint que deve ser seguido.
{
"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
}
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 |
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. |
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.
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.
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
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