O seu código responde.
O webhook de mensagens traz cada nova mensagem para o seu servidor. Responda com os endpoints de envio ou inicie um chatbot Wati nos planos Pro e Business.
API de Resposta Automática e Chatbot do WhatsApp
Quando um cliente escreve, a Wati envia um webhook de mensagem para o seu servidor. Seu código envia a resposta de volta ou inicia um dos chatbots da Wati para esse contato.
Parte da API de desenvolvedor do WhatsApp.
Última atualização em
Regras de palavras-chave, um modelo de sua escolha ou uma consulta no seu sistema de pedidos. A Wati transporta a mensagem em ambas as direções.
O webhook de mensagens traz cada nova mensagem para o seu servidor. Responda com os endpoints de envio ou inicie um chatbot Wati nos planos Pro e Business.
Escolha um modelo aprovado e envie para até 10.000 destinatários. Cada pessoa recebe suas próprias variáveis e cada resultado retorna por número.
Dentro da janela de 24 horas, envie textos, imagens, arquivos, botões de resposta e seletores de lista, com um indicador de digitação enquanto você trabalha.
Sua loja, sistema de reservas ou de faturamento envia um modelo aprovado quando algo muda. Os clientes tocam em um botão ou respondem.
Os webhooks enviam novas mensagens, confirmações de leitura, cliques e falhas para a sua URL. Sem polling.
As respostas chegam à caixa de entrada da equipe Wati. Atribua um operador, defina o status e adicione etiquetas via API, para que a pessoa certa assuma o atendimento.
Crie e atualize contatos com atributos personalizados e, em seguida, visualize uma prévia do segmento antes de enviar mensagens.
Liste comentários nas suas publicações, responda publicamente ou envie uma resposta privada.
Vincule seu número do WhatsApp por meio do Cadastro Incorporado da Meta dentro do Wati.
Crie um token de API no Wati e conceda a ele apenas os escopos necessários. Mantenha-o em seu servidor.
Envie um modelo aprovado com uma única requisição. Em seguida, adicione um webhook para acompanhar a entrega.
Veja o que compõe uma requisição e onde cada parte aparece na mensagem.
O número do WhatsApp do cliente, com o código do país.
phone_number14155552671O nome de um modelo que a Meta aprovou na sua conta.
template_nameorder_updateOs valores para os campos em branco do modelo, um por pessoa.
custom_paramsname = Mayaorder_id = 10482Seu token de API, enviado em cada requisição. Mantenha-o em seu servidor.
Authorization: Bearer <token>Um código 200 significa que o Wati aceitou a mensagem, junto com um broadcast_id. Os status de entregue e lido chegam posteriormente via webhook.
200broadcast_idO texto da mensagem e order_update são exemplos. O texto exato é definido pelo seu modelo aprovado.
O comentário ao qual você está respondendo. Você obtém o ID dele ao listar os comentários de uma publicação.
comment_idno caminho da URLSua conta do Instagram conectada ao Wati.
channelA pessoa que escreveu o comentário, obtida a partir do próprio comentário.
userIduserNameTexto simples de até 1.000 caracteres ou um modelo com botões.
type = texttexttype = templateUm código 200 com ok definido como true significa que a resposta privada foi enviada com sucesso. Use o mesmo cabeçalho Authorization de qualquer outra chamada.
ok: trueresult: successPOST /api/ext/v3/comments/{comment_id}/privateReply. O comentário e o texto da resposta são exemplos. Consulte a requisição na documentação
Conecte-se por meio do Cadastro Incorporado da Meta. A conta do WhatsApp Business é registrada em sua empresa.
Alterações de aprovação, qualidade e categoria chegam como webhooks, para que você saiba antes que um envio falhe.
Até 144 tentativas, a cada 10 minutos. Se o seu endpoint continuar falhando, o Wati envia um e-mail para você.
Se você for rápido demais, receberá um erro 429 com um cabeçalho Retry-After. As mensagens aceitas ficam aguardando em uma fila.
Uma caixa de entrada compartilhada da equipe para conversas que seu código não deve responder sozinho.
A versão v3 oferece suporte a tokens com escopo, garantindo que cada integração obtenha apenas o acesso necessário.
Agende o envio de um modelo para mais tarde com uma única chamada. O Wati envia na hora certa.
Estime o custo de uma transmissão antes que qualquer mensagem seja enviada.
Inicie conversas com modelos aprovados, agora ou em horário agendado.
Documentação →GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/scheduleLeia os resultados da campanha e o status por destinatário, e estime o custo antecipadamente.
Documentação →GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-costResponda com texto, mídia ou botões dentro da janela de 24 horas.
Documentação →POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicatorListe seus chatbots do Wati e inicie um para um contato.
Documentação →GET/chatbotsPOST/chatbots/startGerencie assinaturas e liste os tipos de eventos que você pode receber.
Documentação →GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}Sincronize contatos e atributos do seu CRM e, em seguida, segmente o público-alvo.
Documentação →POST/contactsPUT/contactsPOST/segments/evaluateAtribua um operador, altere o status, adicione ou remova tags.
Documentação →PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tagsListe postagens e comentários, responda publicamente ou em privado e verifique permissões.
Documentação →GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissionsOs caminhos são relativos a https://live-mt-server.wati.io/api/ext/v3. A criação de um webhook usa o caminho legado POST /{tenantId}/api/v2/webhookEndpoints.
Para agentes de IA, o servidor Wati MCP cobre as mesmas ações do WhatsApp e pode responder a DMs do Instagram e chats do Messenger com texto.
Versões BSUID de vários eventos também estão disponíveis. Documentação de webhooks
Chamadas para enviar modelos, dependendo do seu plano (Growth, Pro ou Business).
Um modelo, para até 10.000 pessoas, cada uma com suas próprias variáveis.
Texto, mídia e botões exigem uma janela de atendimento ao cliente aberta. Fora dela, envie um modelo.
O Wati informa quanto tempo você deve esperar. As mensagens aceitas são processadas em uma fila.
| Endpoint | Growth | Pro | Business |
|---|---|---|---|
/addContact, /getContacts | 10 / 10 s | 10 / 10 s | 10 / 10 s |
/getMessages | 10 / 10 s | 10 / 10 s | 10 / 10 s |
/sendTemplateMessage | 30 / 10 s | 60 / 10 s | 100 / 10 s |
/sendTemplateMessages | 30 / 10 s | 60 / 10 s | 100 / 10 s |
Limites conforme publicados em Erros e Limites de Taxa, listados pelo nome do endpoint. A chamada em lote da v1 aceita até 1.000 contatos. Os endpoints principais de mensageria, modelos e contatos estão incluídos em todos os planos. Atribuição de equipe, status do chat, chatbots e segmentos personalizados exigem os planos Pro ou Business. A atualização de atributos para vários contatos de uma só vez exige o plano Business. Disponibilidade de endpoints por plano. Para limites mais altos, fale com o Wati sobre o seu caso de uso.
Sim, de duas formas. O Wati envia cada mensagem recebida para a sua URL com o webhook message, e o seu código responde com os endpoints de mensagens. Ou, nos planos Pro e Business, POST /chatbots/start inicia um chatbot que você criou no Wati para um contato. Não existe um único endpoint de resposta automática: o seu código ou o seu chatbot do Wati decide o que dizer.
Liste seus chatbots com GET /chatbots e, em seguida, chame POST /chatbots/start com o contato e o chatbot_id. Use isso quando o fluxo já estiver construído no Wati e seu código apenas decidir quando ele é executado. O webhook chatbotTriggered avisa quando um chatbot é executado. Ambos os endpoints exigem um plano Pro ou Business.
Sim. Seu código recebe o texto da mensagem no webhook, pode passá-lo para qualquer modelo ou serviço de sua escolha e envia a resposta com os endpoints de texto ou interativos. Respostas em formato livre funcionam dentro da janela de 24 horas, que fica aberta porque o cliente acabou de escrever para você.
Menos do que antes. Os criadores de aplicativos de IA podem escrever as chamadas de API a partir de instruções em inglês simples, e os exemplos nesta página mostram cada chamada.
Você ainda precisa de um número do WhatsApp conectado ao Wati, um token de API e um modelo aprovado pela Meta antes de poder iniciar uma conversa. Se uma ferramenta de IA escrever o código, verifique se o seu token permanece no servidor.
As chamadas de contato e histórico de mensagens são limitadas a 10 solicitações a cada 10 segundos em todos os planos. Os envios de modelos são limitados a 30, 60 ou 100 solicitações a cada 10 segundos nos planos Growth, Pro e Business. Quando você atinge um limite, recebe o erro HTTP 429 com um cabeçalho Retry-After. Para limites maiores, entre em contato com o Wati.
No WhatsApp, textos em formato livre, mídias e mensagens interativas exigem uma janela de atendimento ao cliente aberta de 24 horas. Fora dessa janela, inicie a conversa com um modelo aprovado pela Meta.
O aplicativo Business é para chats manuais em um telefone, com até 5 dispositivos vinculados e listas de transmissão limitadas a 256 contatos. A API conecta o WhatsApp aos seus próprios sistemas. Você pode enviar modelos aprovados em volume, automatizar respostas, receber webhooks e compartilhar um único número em uma caixa de entrada da equipe.
Endpoints principais de mensagens, modelos e contatos estão disponíveis em todos os planos. Atribuição de equipe, status do chat, chatbots e segmentos personalizados exigem os planos Pro ou Business. A documentação lista a disponibilidade de endpoints por plano.
Comece gratuitamente, conecte seu número do WhatsApp no Wati e faça sua primeira chamada.