Transmissões
Mensagens pessoais, enviadas em escala.
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.
API de Transmissão do WhatsAppEnvie um modelo para até 10.000 clientes por chamada de API.
Uma solicitação envia um modelo aprovado para até 10.000 pessoas, cada uma com seus próprios detalhes. Agende, estime o custo primeiro e, em seguida, leia os resultados por destinatário.
Prefere sem código? Envie uma transmissão no WhatsApp pelo Wati.
- 16.000+empresas em mais de 190 países
- 4,6/5avaliação média no G2
- OficialParceiro de Negócios da Meta e BSP do WhatsApp
Uma solicitação. Até 10.000 clientes.
Cada pessoa recebe seu próprio nome, pedido ou data. Cada resultado retorna por número.
- Começa com um modeloUm modelo aprovado inicia a conversa, para um cliente ou até 10.000 por chamada.
- Continua no chat ou em uma chamadaTexto, mídia e botões assim que o cliente responde, ou uma chamada de voz na mesma conversa.
- Termina com a sua equipeWebhooks informam o seu código. A caixa de entrada da equipe informa as pessoas.
O produto
Envie. Responda. Receba retornos. Transfira.
Mensagens
Responda com mais do que texto.
Dentro da janela de 24 horas, envie texto, imagens, arquivos, botões de resposta e seletores de lista, com um indicador de digitação enquanto você trabalha.
Atualizações de pedidos e alertas
A atualização certa, no momento em que ela acontece.
Sua loja, sistema de agendamento ou de faturamento envia um modelo aprovado quando algo muda. Os clientes tocam em um botão ou respondem.
Resposta automática e chatbots
Seu código responde.
O webhook de mensagem traz cada nova mensagem para o seu servidor. Responda com os endpoints de envio ou inicie um chatbot Wati nos planos Pro e Business.
Webhooks
Cada resposta, no momento em que ela chega.
Os webhooks enviam novas mensagens, confirmações de leitura, cliques e falhas para a sua URL. Sem polling.
Caixa de entrada da equipe
O código começa. As pessoas terminam.
As respostas chegam na caixa de entrada da equipe do Wati. Atribua um operador, defina o status e adicione marcadores via API, para que a pessoa certa assuma o atendimento.
Contatos e segmentos
Seu CRM, espelhado no Wati.
Crie e atualize contatos com atributos personalizados, depois visualize uma prévia de um segmento antes de enviar mensagens.
InstagramComentários do Instagram
Crie automação no Instagram também.
Liste comentários em suas postagens, responda publicamente ou envie uma resposta privada. DMs do Instagram também funcionam: responda a conversas ativas via REST ou através do servidor Wati MCP.
Fragment 1 de 2. Traduza apenas o texto dentro deste item.
Instagram
Começar
Ativo em três passos.
- Conectar
Conecte seu número
Vincule seu número do WhatsApp por meio do Cadastro Incorporado da Meta dentro do Wati.
- Autenticar
Obtenha um token
Crie um token de API no Wati e conceda a ele apenas os escopos necessários. Mantenha-o em seu servidor.
- Enviar
Faça sua primeira chamada
Envie um modelo aprovado com uma única requisição. Em seguida, adicione um webhook para acompanhar a entrega.
Sua primeira requisição, explicada
Veja o que compõe uma requisição e onde cada parte aparece na mensagem.
- Quem
O número de WhatsApp do cliente, com o código do país.
phone_number14155552671 - Qual mensagem
O nome de um modelo que a Meta aprovou na sua conta.
template_nameorder_update - O que preencher
Os valores para os espaços em branco no modelo, um por pessoa.
custom_paramsname = Mayaorder_id = 10482 - Sua chave
Seu token de API, enviado com cada requisição. Mantenha-o em seu servidor.
Authorization: Bearer <token> - O que você recebe de volta
Um código 200 significa que o Wati aceitou a mensagem, junto com um broadcast_id. Os status de entregue e lido chegam posteriormente por webhook.
200broadcast_id
O texto da mensagem e order_update são exemplos. O seu modelo aprovado define a redação.
- Qual comentário
O comentário ao qual você está respondendo. Você obtém o ID dele ao listar os comentários de uma postagem.
comment_idno caminho da URL - De qual conta
Sua conta do Instagram conectada ao Wati.
channel - Para quem
A pessoa que escreveu o comentário, obtida a partir do mesmo comentário.
userIduserName - O que enviar
Texto simples de até 1.000 caracteres ou um modelo com botões.
type = texttexttype = template - O que você recebe de volta
Um código 200 com ok definido como true significa que a resposta privada foi enviada. Use o mesmo cabeçalho Authorization de qualquer outra chamada.
ok: trueresult: success
POST /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
Exemplos em cURL, Node, Python e PHP. A requisição selecionada corresponde a esta página.
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send" \
-H "Authorization: Bearer $WATI_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"template_name": "order_update",
"broadcast_name": "order_update_api",
"recipients": [
{
"phone_number": "14155552671",
"custom_params": [
{ "name": "name", "value": "Maya" },
{ "name": "order_id", "value": "10482" }
]
}
]
}'200Exemplo de respostaFormato do exemplo da documentação
{
"success": true,
"broadcast_id": "broadcast_123456",
"recipients": [
{
"local_message_id": "local-msg-123",
"phone_number": "14155552671",
"errors": []
}
]
}URL do servidor para a região do seu espaço de trabalho
Global
https://mcp.wati.io/mcpUE
https://eu-mcp.wati.io/mcpClientes com uma configuração de mcpServers
{
"mcpServers": {
"wati": {
"url": "https://mcp.wati.io/mcp"
}
}
}Claude Code
claude mcp add --transport http wati https://mcp.wati.io/mcpFaça login com OAuth quando seu cliente solicitar. Nenhuma chave de API vai na configuração. Para espaços de trabalho na UE, use a URL da UE. Documentação do MCP
Integrado
O que o Wati gerencia para que você não precise se preocupar.
Integração de número
Conecte-se por meio do Cadastro Incorporado da Meta. A Conta do WhatsApp Business é registrada em sua empresa.
Status do modelo
Aprovações, qualidade e alterações de categoria chegam como webhooks, para que você saiba antes que um envio falhe.
Tentativas de webhook
Até 144 tentativas, a cada 10 minutos. Se o seu endpoint continuar falhando, o Wati envia um e-mail para você.
Limites de taxa e enfileiramento
Se você for rápido demais, receberá um erro 429 com um cabeçalho Retry-After. As mensagens aceitas ficam aguardando em uma fila.
Atendimento humano
Uma caixa de entrada compartilhada para a equipe para as conversas que seu código não deve responder sozinho.
Tokens de API com escopo
A v3 oferece suporte a tokens com escopo, garantindo que cada integração obtenha apenas o acesso necessário.
Envios agendados
Agende o envio de um modelo para mais tarde com uma única chamada. O Wati o envia no horário certo.
Estimativa de custo prévia
Estime quanto custará uma transmissão antes que qualquer mensagem seja enviada.
Nos bastidores
Os endpoints, por funcionalidade.
O que é incluído em uma chamada de transmissão
| Campo | Obrigatório | Observações |
|---|---|---|
template_name | Sim | Um modelo aprovado em sua conta. Liste-os com GET /messageTemplates. |
broadcast_name | Sim | Seu próprio rótulo para este envio |
recipients | Sim | 1 a 10.000 pessoas, cada uma com um phone_number |
custom_params | Por destinatário | Pares de nome e valor para as variáveis do modelo |
local_message_id | Não | Seu próprio ID, retornado nos resultados por destinatário |
channel | Não | O número de envio, por nome ou número. Canal padrão se omitido. |
Do esquema do endpoint de envio v3. A resposta contém success, um broadcast_id e errors por destinatário.
Modelos
Inicie conversas com modelos aprovados, agora ou agendados.
Documentação →GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/scheduleTransmissões
Leia os resultados da campanha e o status por destinatário, e estime o custo primeiro.
Documentação →GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-costMensagens
Responda 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/typingIndicatorChatbots Pro+
Liste seus chatbots do Wati e inicie um para um contato.
Documentação →GET/chatbotsPOST/chatbots/startWebhooks
Gerencie inscrições e liste os tipos de eventos que você pode receber.
Documentação →GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}Contatos e & segmentos
Sincronize contatos e atributos do seu CRM, depois segmente o público-alvo.
Documentação →POST/contactsPUT/contactsPOST/segments/evaluateCaixa de entrada da equipe
Atribua um operador, altere o status, adicione ou remova tags.
Documentação →PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tagsChamadas
Leia registros de chamadas, gravações, transcrições e resumos. Somente leitura.
Documentação →GET/callsGET/calls/{call_id}/transcriptGET/calls/{call_id}/summaryListe publicações e comentários, responda publicamente ou em privado, 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 abrange as mesmas ações do WhatsApp e pode responder a DMs do Instagram e chats do Messenger com texto.
Ver todos os 19 tipos de eventos de webhook do WhatsApp
Mensagens
- message
- newContactMessageReceived
- sessionMessageSent_v2
- templateMessageSent_v2
Status de entrega
- sentMessageDELIVERED_v2
- sentMessageREAD_v2
- sentMessageREPLIED_v2
- templateMessageFailed
Modelos e conta
- templateReviewed
- templateQualityUpdated
- templateCategoryUpdated
- wabaStatusReviewUpdate
- PhoneNumberQualityUpdatedEvent
- accountUpdated
- accountDeleted
- phoneNumberDeleted
Engajamento e chamadas
- chatbotTriggered
- ctaUrlClicked
- call.status
Apenas eventos do WhatsApp: ainda não há eventos de webhook do Instagram. Versões BSUID de vários eventos também estão disponíveis. Documentação de webhooks
Limites e planos
Limites claros. Publicados.
30 a 100 por 10 s
Envios de modelos
Chamadas para enviar modelos, dependendo do seu plano (Growth, Pro ou Business).
10.000 destinatários
Por chamada de envio v3
Um modelo, até 10.000 pessoas, cada uma com suas próprias variáveis.
24 h janela
Respostas em formato livre
Texto, mídia e botões precisam de uma janela de atendimento ao cliente aberta. Fora dela, envie um modelo.
429 Retry-After
Quando você vai rápido demais
O Wati informa quanto tempo esperar. As mensagens aceitas são processadas em uma fila.
Limites de taxa e disponibilidade de planos em detalhes
| 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 mensagens, modelos e contatos estão disponíveis em todos os planos. A 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.
Quantas pessoas posso alcançar com uma única chamada da Broadcast API?
Até 10.000 destinatários por chamada de envio da v3. Você envia um modelo aprovado, e cada destinatário pode ter suas próprias variáveis, como um nome ou número do pedido. Os envios de modelos são limitados a 30, 60 ou 100 chamadas a cada 10 segundos, dependendo do seu plano. O limite de mensagens da Meta para o seu número e a qualidade do modelo ainda se aplicam, portanto, aqueça um novo número antes de envios em massa.
Posso agendar uma transmissão e verificar o custo primeiro?
Sim. POST /messageTemplates/schedule envia no horário escolhido e POST /broadcasts/estimate-cost estima o custo antes que qualquer coisa seja enviada.
Como faço para ver quem recebeu e leu uma transmissão?
Chame GET /broadcasts para suas campanhas e GET /broadcasts/{broadcast_id}/recipients para o status por destinatário. Para atualizações em tempo real, assine webhooks como sentMessageDELIVERED_v2, sentMessageREAD_v2 e templateMessageFailed.
Como faço para associar os resultados aos meus próprios registros?
Atribua a cada destinatário um local_message_id, como o ID do seu pedido. O Wati o retorna nos resultados por destinatário da chamada de envio, ao lado de quaisquer erros para esse número.
Posso escolher qual número do WhatsApp envia a transmissão?
Sim. Passe channel com o nome ou número do canal de envio. Deixe em branco para enviar a partir do seu canal padrão.
Preciso saber programar?
Menos do que antes. Construtores de aplicativos de IA podem escrever as chamadas de API a partir de instruções em linguagem 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.
Quais são os limites de taxa da API?
As chamadas de contato e de 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.
Posso enviar mensagem para um cliente a qualquer momento?
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.
Qual é a diferença entre o aplicativo WhatsApp Business e a API?
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.
Sua primeira mensagem está a apenas uma solicitação de distância.
Obtenha acesso, conecte seu número do WhatsApp no Wati e faça sua primeira chamada.