Sim, dá para disparar mensagem a partir de outro sistema. A tela se chama Notificações (no menu, visível para administrador). É o caminho de FORA PARA DENTRO: seu sistema manda um POST e o Socialmaker envia o WhatsApp.
Não confunda com o bloco Webhook do Fluxo. Aquele é o contrário — o Socialmaker avisa um sistema seu quando algo acontece numa conversa. Se você quer *mandar* mensagem de fora, é Notificações.
Como funciona (é diferente de uma API de envio comum)
Não existe um endereço genérico do tipo "envie esta mensagem para este número". O que existe é melhor para quem integra uma vez e usa sempre: você cadastra uma regra dizendo o que fazer quando um JSON chegar, e depois é só mandar o JSON.
- Abra Notificações. O sistema gera um endereço só seu, assim:
https://api.socialmaker.com.br/functions/v1/notification-webhook/SEUCODIGO - Crie uma regra. Nela você aponta, dentro do JSON, onde está o telefone de quem vai receber — e o que enviar: um modelo de mensagem (API Oficial) ou um texto (conexão direta).
- Seu sistema manda um POST com o JSON para aquele endereço. Pronto.
Autenticação
O próprio endereço é a credencial: aquele código no fim da URL é único e secreto. Não há token nem chave separada para mandar no cabeçalho. Trate a URL como senha — quem tiver ela consegue disparar pela sua conta. Se vazar, apague o webhook e gere outro.
O que a regra envia depende da conexão
- Número da API Oficial: a regra envia um modelo aprovado pela Meta. Como o disparo parte do seu sistema, quase sempre a pessoa não falou com você nas últimas 24 horas, e nesse caso o WhatsApp exige modelo. Aprove o modelo no menu Templates antes de montar a regra. Os dados do JSON entram como variáveis do modelo.
- Número da conexão direta (não-oficial): a regra envia um texto que você escreve, com as variáveis do JSON, e pode esperar alguns segundos antes de enviar (campo "Atraso antes de enviar"). Para proteger o número, os envios saem um de cada vez, com alguns segundos de intervalo entre eles.
Teste antes de valer
Em Notificações há o campo Modo:
- Teste (envia pro número abaixo) — tudo o que chegar vai para um número seu, para você conferir o formato sem incomodar cliente.
- Produção (envia pro telefone do JSON) — vale para valer.
Comece em Teste, confira, depois vire para Produção.
Limites
Até 60 chamadas por minuto e 5.000 por dia em cada endereço. Passando disso, o sistema recusa com erro 429 e seu sistema deve tentar de novo mais tarde.
Além de enviar mensagem
A mesma regra pode criar um card no CRM e cadastrar o contato automaticamente — útil para venda aprovada, pedido novo, lead de formulário. Dá para fazer só o card, só a mensagem, ou os dois.