Enviar mensagens WhatsApp automaticamente a partir dos seus próprios sistemas
Para enviar mensagens WhatsApp automaticamente a partir dos seus sistemas, chame a Cloud API da Meta: um POST para o endpoint /messages do número, com um token de acesso. Uma mensagem para quem não escreveu nas últimas 24 horas tem de ser um template aprovado; o texto livre só funciona nas 24 horas seguintes à última mensagem do cliente. As respostas a mensagens recebidas podem ser automatizadas em separado.
A easyCoexistence liga o número WhatsApp Business que já usa à Cloud API da Meta através da Coexistence e entrega-lhe as suas credenciais no painel ou através de get_api_credentials, para que os seus sistemas enviem templates e respostas a partir desse número, enquanto a app continua no telemóvel.
As mensagens que não são templates só seguem nas 24 horas após a última mensagem do cliente; depois disso, só os templates são entregues.
Throughput fixo da Cloud API de um número usado em simultâneo na app WhatsApp Business e na API.
As mensagens enviadas e recebidas pela Cloud API são espelhadas na app WhatsApp Business num número Coexistence.
Pessoas únicas que um novo portefólio empresarial pode alcançar fora de uma janela de atendimento num período móvel de 24 horas.
O endpoint de envio que a easyCoexistence lhe entrega para um número: a base da Graph API, o Phone number ID e, depois, /messages.
Que mensagens é que os seus sistemas podem enviar sozinhos?
Há dois tipos, e o tempo desde a última mensagem do cliente decide qual deles a Meta aceita. Um sistema que envia uma confirmação de encomenda, um lembrete de marcação ou um recibo de pagamento a quem não escreveu hoje precisa de um template aprovado. Um sistema que responde a uma pergunta feita há uma hora pode enviar texto livre. A Meta cobra as mensagens cobráveis à conta WhatsApp Business da própria empresa, por mensagem, por categoria e por país, sem qualquer margem da easyCoexistence.
| Approved template | Free-form message | |
|---|---|---|
| When it is allowed | Any time, to a person who opted in | Within 24 hours of the customer's last message |
| Review | Meta reviews it first, usually in minutes, up to about 24 hours | None |
| Typical use | Order shipped, appointment tomorrow, payment received | Answering a question, sending a link they asked for |
| Content | Fixed text with variables filled per person | Any text, media or interactive message |
Onde obtenho as credenciais para enviar?
Na página do número no painel da easyCoexistence, ou através da sua IA. Em "Pôr este número a funcionar", o cartão "Ligar o seu próprio sistema" lista a base da API, o endpoint de envio, o WABA ID e o Phone number ID, com "Revelar token de acesso" para o token e "Mostrar exemplo curl" para um pedido pronto a usar. Trate o token como uma palavra-passe: quem o tiver pode enviar mensagens em nome da sua empresa. Se o cartão indicar que não foi emitido nenhum token, clique em "Voltar a ligar para emitir um token" a partir de um computador; uma nova ligação apenas acrescenta um token. Peça ao ChatGPT ou ao Claude "as credenciais da API do meu número" e ele chama get_api_credentials, que devolve os mesmos valores.
curl -X POST "https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "template",
"template": {
"name": "order_shipped",
"language": { "code": "en_US" },
"components": [{
"type": "body",
"parameters": [
{ "type": "text", "text": "Ana" },
{ "type": "text", "text": "#1042" }
]
}]
}
}'A sua IA pode enviar a mensagem em vez de código?
Sim, para mensagens que decida enviar agora. Com o conector da easyCoexistence no ChatGPT ou no Claude, "Envie o template order_shipped para 5511999998888 com Ana e #1042" torna-se uma única chamada send_template, e "Responda à Ana que o bolo está pronto" torna-se send_message, que só funciona nas 24 horas após a última mensagem dela. Cada chamada envia para uma pessoa, e o ChatGPT pode pedir-lhe confirmação antes de executar uma ferramenta que escreve. Isto serve para envios pontuais e verificações. Um trabalho que tem de correr sozinho, em cada nova encomenda, não corre dentro do assistente: o seu sistema ou um fluxo n8n pode chamar a Cloud API diretamente, ou enviar por POST o número da pessoa para uma automatização de webhook no número, que envia um template aprovado com os detalhes da encomenda preenchidos como variáveis.
Que eventos costumam desencadear uma mensagem WhatsApp automática?
Algo que já acontece no seu software de gestão, convertido num único envio de template. O padrão é o mesmo em todos: o evento dispara um webhook ou um fluxo, o fluxo preenche as variáveis do template a partir do registo e publica a mensagem no endpoint de envio. Templates deste tipo são normalmente UTILITY, desde que não incluam nenhuma oferta:
- Uma encomenda é paga ou enviada na sua loja: confirmação ou rastreio, com o número da encomenda.
- Uma marcação é criada ou tem lugar amanhã na sua ferramenta de agendamento: a data, a hora e a morada.
- Um pagamento é recebido ou está em atraso no seu sistema de faturação: o montante e uma ligação.
- Um formulário é submetido no seu site com a opção de consentimento WhatsApp marcada: uma primeira mensagem que o confirma.
O que acontece quando um cliente responde a uma mensagem automática?
A resposta chega à app WhatsApp Business como qualquer outra mensagem e abre uma janela de 24 horas, em que pode voltar a enviar qualquer texto. Num número configurado como "Através do easyCoexistence", a resposta pode também iniciar uma automação: uma resposta por palavra-chave para perguntas frequentes, um menu com botões, um agente de IA ou um passo "Responder com IA" com a sua própria chave, ou "Chamar o seu webhook" para a entregar ao seu sistema. Pode acrescentar um URL de reencaminhamento para receber também no seu sistema as mensagens em bruto e os estados de entrega, assinados por número. Com "Diretamente para o seu sistema", a Meta entrega tudo no seu endpoint, e as automatizações ficam desligadas. A sua equipa pode responder a partir do telemóvel em qualquer momento, e as mensagens que o seu sistema enviou aparecem na mesma conversa.
Que limites se aplicam às mensagens que os seus sistemas enviam?
Os da Meta, e aplicam-se a qualquer fornecedor. Planeie o sistema em função deles, em vez de os descobrir num webhook de estado de falha:
- Throughput: um número Coexistence envia até 20 mensagens por segundo.
- Limite de mensagens: pessoas únicas alcançadas fora de uma janela, por período móvel de 24 horas, definido por portefólio empresarial; os novos portefólios começam em 250.
- Método de pagamento: sem um na conta WhatsApp Business, a Meta aceita os templates e depois deixa-os cair; a easyCoexistence envia-lhe um email quando isso começar.
- Qualidade: bloqueios e denúncias baixam a classificação de qualidade do número, e uma classificação baixa leva a Meta a limitar a conta.
Como configurar
- Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow; the app keeps working on the phone.
- Get a template approvedAsk your AI to create a UTILITY template such as order_shipped with create_template, or make it in WhatsApp Manager, and wait until its status is APPROVED.
- Copy the credentialsOpen the number in the dashboard, go to "Plug in your own system", copy the Send endpoint and click "Reveal access token".
- Send from your systemHave your store, CRM or n8n workflow POST the template to the Send endpoint when the event happens, with the variables filled from the record.
- Receive replies and statusesUnder "Where incoming messages go", choose "Through easyCoexistence" with a Forward URL, or "Straight to your system" with your endpoint as the destination, so replies and delivery statuses reach your system.
Erros comuns
- Enviar texto livre a quem escreveu pela última vez há dois dias. A Meta recusa-o com o erro 131047; envie então um template aprovado, e passe para texto quando a pessoa responder.
- Colocar o token de acesso numa página web, num pacote de app ou numa folha de cálculo partilhada. Quem o ler pode enviar mensagens em nome da sua empresa; mantenha-o num servidor.
- Dar como entregue um ID de mensagem da resposta da API. A Meta aceita o envio e só depois o pode falhar, por isso acompanhe o webhook de estado para failed e o respetivo código de erro.
- Repetir envios falhados em ciclo apertado. Um limite por utilizador ou um erro de marketing suspenso não se resolve em segundos, e as repetições só acrescentam erros.
As automatizações respondem ao que os clientes escrevem, e cada número é monitorizado 24/7, com um email quando a Meta deixa de entregar os seus templates. A partir de US$ 9 por número ligado por mês, descendo até US$ 0,75 à medida que acrescenta números, com os primeiros 3 dias grátis.
Perguntas frequentes
As mensagens que o seu sistema envia aparecem na app WhatsApp Business?
Sim. Num número Coexistence, a Meta espelha as mensagens entre a Cloud API e a app, por isso um template enviado pelo seu sistema aparece na conversa desse cliente no seu telemóvel, e a resposta dele chega também lá. Pode continuar a conversa a partir da app.
O seu sistema pode enviar imagens ou PDF automaticamente?
Sim, pelo mesmo endpoint: uma mensagem de media nas 24 horas após a última mensagem do cliente, ou um template cujo cabeçalho contenha uma imagem ou um documento, a qualquer momento. O passo Send a picture or file de uma automatização também envia uma das suas imagens ou PDFs, dentro das mesmas 24 horas, e um agente de IA pode enviá-los sozinho.
Envio através de uma API da easyCoexistence ou diretamente pela Meta?
Através da Meta. O seu sistema chama diretamente a Graph API com o token de acesso do próprio número, por isso a easyCoexistence não retransmite nem guarda as mensagens que envia e não aplica qualquer margem sobre o que a Meta cobra por elas.
Uma ferramenta sem código ou uma folha de cálculo pode enviar mensagens WhatsApp?
Sim, desde que consiga fazer um POST HTTP: o n8n, o Make, o Zapier e o Google Sheets com Apps Script conseguem todos. Aponte-a para o endpoint de envio, passe o token de acesso no cabeçalho Authorization e envie um template aprovado, um destinatário por pedido.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em