API da Wati
API da Wati: uma única API para WhatsApp, Instagram e seu agente de IA.
Envie mensagens para clientes no WhatsApp e no Instagram a partir do seu próprio produto, ou permita que um assistente de IA faça isso através do servidor MCP da Wati.
- Agentes de IA (MCP)
- TikTok Em breve
- Messenger Em breve
Última atualização em
- 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 única API. WhatsApp, Instagram e seu assistente de IA.
Alcance clientes nos aplicativos que eles já usam. Integre ao seu código ou entregue a um agente de IA.
- Dois canais ativosWhatsApp e Instagram hoje. TikTok e Messenger em breve.
- Com ou sem códigoChame a API REST a partir do seu produto ou conecte um assistente de IA através do servidor MCP.
- Sua equipe continua no controleAs conversas aparecem na caixa de entrada da equipe da Wati, permitindo que uma pessoa assuma o atendimento.
O que a API da Wati cobre
Dois canais de mensagens e um servidor MCP para agentes de IA já estão ativos. TikTok e Messenger são os próximos.
- Ativo
WhatsApp
Envie modelos aprovados para um cliente ou para 10.000, responda no chat, inicie chatbots e receba webhooks.
API do WhatsApp - Ativo
Instagram
Responda a comentários publicamente ou em privado com a API REST. Responda a DMs através do servidor MCP.
API do Instagram - Ativo
Agentes de IA (MCP)
Conecte um assistente de IA com OAuth. Peça em linguagem natural para enviar modelos, responder a chats e atualizar contatos.
Servidor MCP - Em breve
TikTok
Conversas do TikTok na mesma API da Wati.
- Em breve
Messenger
Conversas do Messenger na mesma API da Wati. Os agentes de IA já podem responder com texto através do servidor MCP.
Escolha a API ideal para o seu projeto
- WhatsApp APIVisão geral: modelos, respostas, webhooks e sua primeira chamada.
- Mensagens do WhatsAppEnvie textos, mídias e botões a partir do seu código.
- Transmissão no WhatsAppEnvie um modelo aprovado para vários contatos de uma só vez.
- API de Chatbot do WhatsAppInicie um chatbot da Wati para um contato a partir do seu sistema.
- Webhooks do WhatsAppReceba novas mensagens e o status de entrega em tempo real.
- Servidor MCPConecte seu agente de IA à Wati.
- API do InstagramComentários via API REST, DMs via MCP.
- WhatsApp Flows Em breveFormulários que os clientes preenchem dentro do chat.
- Chamadas do WhatsApp Em breveChamadas de voz no WhatsApp.
- API de Grupos do WhatsApp Em breveGrupos do WhatsApp gerenciados pelo seu sistema.
O que funciona onde
O que você pode fazer em cada canal por meio da API da Wati hoje, verificado com base na documentação pública.
| Recurso | Messenger | TikTok | ||
|---|---|---|---|---|
| Iniciar uma conversa com um modelo aprovado, para uma pessoa ou até 10.000 | API REST e MCP | – | Em breveAgentes de IA já podem responder com texto via MCP. | Em breve |
| Responder em um chat aberto | Texto, mídia e botões. API REST e MCP | MCPRespostas de texto em DM | ||
| Responder a comentários, de forma pública ou privada | – | API REST e MCP | ||
| Webhooks para novas mensagens e status de entrega | API REST | – | ||
| Iniciar um chatbot da Wati para um contato | API REST, planos Pro e Business | – |
API REST: chame a partir do seu código com um token de API. MCP: um assistente de IA faz isso por você através do servidor MCP da Wati. –: indisponível na API hoje. Lista completa na referência da API.
Ativo em três etapas.
- Inscreva-se
Crie sua conta
Inscreva-se no Wati na página de cadastro da API e, em seguida, conecte seu número do WhatsApp ou conta do Instagram.
- Obtenha sua chave
Abra o Console do Desenvolvedor
Crie um token de API e conceda a ele apenas os escopos necessários. Mantenha-o em seu servidor.
- Enviar
Envie sua primeira solicitação
Uma única chamada envia um modelo aprovado. As atualizações de entrega e leitura chegam por webhook.
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": "my_first_call",
"recipients": [{ "phone_number": "14155552671",
"custom_params": [{ "name": "name", "value": "Maya" }] }]
}'Use o nome de um modelo que a Meta aprovou em sua conta. Mais exemplos na página da API do WhatsApp.
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/comments/$COMMENT_ID/privateReply" \
-H "Authorization: Bearer $WATI_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"channel": "yourbrand", "userId": "17841400000000000", "userName": "maya",
"type": "text", "text": "Hi Maya, yes we do."
}'Obtenha o ID do comentário e os detalhes do autor do comentário na lista de comentários da postagem. Mais informações na página da API do Instagram.
Seguro por padrão. Limites publicados.
Modelos primeiro no WhatsApp
Respostas em formato livre exigem uma janela de atendimento ao cliente aberta de 24 horas. Fora dela, comece com um modelo aprovado pela Meta.
Sem chaves em sua ferramenta de IA
Os clientes de IA fazem login no servidor Wati MCP no navegador. Você não precisa colar uma chave de API na ferramenta.
Apenas o acesso que você concede
Cada token de API carrega os escopos que você seleciona e pode ter uma data de validade. Ele é exibido apenas uma vez, portanto, mantenha-o em seu servidor.
Envios de modelos
Dependendo do seu plano. Se for rápido demais, você receberá o erro HTTP 429 com um cabeçalho Retry-After.
Limites de taxa e disponibilidade do plano 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. Endpoints principais de mensagens, modelos e contatos estão disponíveis em todos os planos. Atribuição de equipe, status de chat, chatbots e segmentos personalizados exigem os planos Pro ou Business. Disponibilidade de endpoints por plano. Para limites mais altos, fale com a Wati sobre o seu caso de uso.
O que é a API da Wati?
A API da Wati permite que seu produto envie e receba mensagens de clientes por meio da Wati. Hoje, ela cobre o WhatsApp e o Instagram, além de um servidor MCP para que um assistente de IA possa realizar o mesmo trabalho por chat. Sua equipe pode acompanhar todas as conversas na caixa de entrada da equipe da Wati.
Quais canais a API da Wati suporta?
WhatsApp e Instagram. No WhatsApp, você pode enviar modelos aprovados, responder no chat, iniciar chatbots e receber webhooks. No Instagram, a API REST cobre comentários: listar publicações e comentários, responder publicamente e enviar uma resposta privada. As DMs do Instagram funcionam através do servidor MCP da Wati.
TikTok e Messenger estarão disponíveis em breve.
O TikTok ou o Messenger são suportados?
Ainda não na API. Ambos estarão disponíveis em breve. Um agente de IA conectado ao servidor MCP da Wati já pode responder a chats do Messenger com texto, após fazer login com uma conta da Wati.
Preciso saber programar?
Não. Conecte um assistente de IA que suporte MCP remoto, faça login com o OAuth e pergunte em linguagem simples, por exemplo, para listar seus modelos ou responder a um chat.
Se você preferir programar, a API REST usa uma URL base e um token de autorização (bearer token), e os criadores de aplicativos de IA podem escrever as chamadas para você.
Onde está a documentação?
A referência completa é pública em docs.wati.io: a referência da API, o guia do servidor MCP, os limites de taxa (rate limits) e a disponibilidade de endpoints por plano. Ferramentas de codificação de IA podem ler todo o índice em docs.wati.io/llms.txt.
Como obtenho uma chave de API?
Cadastre-se em live.wati.io/start/api, abra o Console do Desenvolvedor na Wati e crie um token de API apenas com os escopos necessários. O token é exibido apenas uma vez, portanto, armazene-o em seu servidor e nunca em um navegador ou aplicativo móvel.
Em que esta página é diferente da página da API do WhatsApp?
Esta página é a visão geral de todas as APIs da Wati: os canais, o que funciona onde e como começar. A página da API do WhatsApp aprofunda o assunto sobre o WhatsApp, com cada grupo de endpoints, exemplos de código em vários idiomas e os limites completos.
Quais são os limites de taxa da API?
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 a Wati.
Crie soluções no WhatsApp e no Instagram hoje mesmo.
Comece gratuitamente e faça sua primeira chamada ou diga-nos o que você deseja criar.