🚀 Wati AI chegou – A Camada de Inteligência Conversacional para Negócios Modernos Explorar🚀 Wati AI chegou →

Servidor MCP Wati

Servidor MCP do WhatsApp: permita que seu agente de IA trabalhe no WhatsApp.

Conecte qualquer cliente compatível com MCP remoto, inicie sessão com OAuth e pergunte em bom português: liste modelos, visualize um envio de teste, etiquete uma conversa, atualize um contato.

Última atualização em

  • Mais de 16.000empresas em mais de 190 países
  • 4,6/5avaliação média no G2
  • OficialParceiro de Negócios Meta e BSP do WhatsApp
G2 Leader, ChatbotsG2 Leader Mid-Market, ChatbotsG2 Momentum Leader, ChatbotsG2 Most Implementable, WhatsApp MarketingISO 27001GDPR

Uma URL de servidor. Seu agente fala WhatsApp.

Ferramentas para modelos, campanhas, contatos, segmentos e a caixa de entrada da equipe. Inicie sessão uma vez. Sem chave de API na configuração.

  • Começa com um modeloUm modelo aprovado abre a conversa, para um cliente ou 10.000.
  • Continua no chatTexto, mídia e botões assim que o cliente responder.
  • Termina com a sua equipeOs webhooks informam o seu código. A caixa de entrada da equipe informa as suas pessoas.
O produto

Envie. Responda. Obtenha retorno. Transfira.

Transmissões

Mensagens personalizadas, 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.

Mensagens

Responda com mais do que texto.

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.

Atualizações de pedidos e alertas

A atualização certa, no momento em que acontece.

Sua loja, sistema de reservas ou 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 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.

Webhooks

Cada resposta, no momento em que 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 à caixa de entrada da equipe Wati. Atribua um operador, defina o status e adicione tags 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 e, em seguida, visualize uma prévia do segmento antes de enviar mensagens.

InstagramComentários e DMs do Instagram

Crie automação no Instagram também.

Liste comentários nas suas publicações, responda publicamente ou envie uma resposta privada.

Começar

Ativo em três passos.

  1. Conectar

    Conecte seu número

    Vincule seu número do WhatsApp por meio do Cadastro Incorporado da Meta dentro do Wati.

  2. 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.

  3. 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.

  1. Quem

    O número do WhatsApp do cliente, com o código do país.

    phone_number14155552671
  2. Qual mensagem

    O nome de um modelo que a Meta aprovou em sua conta.

    template_nameorder_update
  3. O que preencher

    Os valores para os espaços em branco no modelo, um por pessoa.

    custom_paramsname = Mayaorder_id = 10482
  4. Sua chave

    Seu token de API, enviado com cada requisição. Mantenha-o em seu servidor.

    Authorization: Bearer <token>
  5. O que você recebe de volta

    Um status 200 significa que o Wati aceitou a mensagem, junto com um broadcast_id. Os status de entregue e lido chegam posteriormente via webhook.

    200broadcast_id

O texto da mensagem e order_update são exemplos. O texto exato é definido pelo seu modelo aprovado.

Código pronto para usoOcultar o código
Integrado

O que o Wati resolve para você não precisar se preocupar.

Cadastro de números

Conecte-se por meio do Cadastro Incorporado da Meta. A conta do WhatsApp Business é registrada em nome da sua empresa.

Status de modelos

Alterações de aprovação, qualidade e categoria chegam como webhooks, para você saber antes que um envio falhe.

Novas tentativas de webhook

Até 144 tentativas, a cada 10 minutos. Se o seu endpoint continuar falhando, o Wati envia um e-mail.

Limites de taxa e enfileiramento

Se você enviar mensagens rápido demais, receberá um erro 429 com um cabeçalho Retry-After. As mensagens aceitas ficam aguardando em uma fila.

Transição para atendimento humano

Uma caixa de entrada compartilhada para a equipe gerenciar as conversas que o seu código não deve responder sozinho.

Tokens de API com escopo

A versão v3 oferece suporte a tokens com escopo, garantindo que cada integração tenha apenas o acesso necessário.

Envios agendados

Agende o envio de um modelo para mais tarde com uma única chamada. O Wati envia na hora certa.

Estimativa de custo prévia

Estime o custo de uma transmissão em massa antes de enviar qualquer mensagem.

Nos bastidores

Os endpoints, por funcionalidade.

Modelos

Inicie conversas com modelos aprovados, agora ou em horário agendado.

Documentação →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

Transmissões

Consulte os resultados de campanhas e o status por destinatário, além de estimar custos antecipadamente.

Documentação →
GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

Mensagens

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/typingIndicator

Chatbots Pro+

Liste seus chatbots do Wati e inicie um para um contato.

Documentação →
GET/chatbotsPOST/chatbots/start

Webhooks

Gerencie assinaturas 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 e, em seguida, defina segmentos de público-alvo.

Documentação →
POST/contactsPUT/contactsPOST/segments/evaluate

Caixa de entrada da equipe

Atribua um operador, altere o status e adicione ou remova tags.

Documentação →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

Liste publicações e comentários, responda publicamente ou em modo privado e verifique permissões.

Documentação →
GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions

Os caminhos são relativos a https://live-mt-server.wati.io/api/ext/v3. A criação de um webhook utiliza 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.

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

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 envio de modelos, dependendo do seu plano (Growth, Pro ou Business).

10.000 destinatários

Por chamada de envio v3

Um modelo, para até 10.000 pessoas, cada uma com suas próprias variáveis.

24 h de janela

Respostas livres

Textos, mídias e botões exigem uma janela de atendimento ao cliente aberta. Fora dela, envie um modelo.

429 Retry-After

Quando você envia rápido demais

O Wati informa quanto tempo você deve esperar. As mensagens aceitas são processadas em uma fila.

Limites de taxa e disponibilidade de planos em detalhes
Limites de taxa documentados por plano
EndpointGrowthProBusiness
/addContact, /getContacts10 / 10 s10 / 10 s10 / 10 s
/getMessages10 / 10 s10 / 10 s10 / 10 s
/sendTemplateMessage30 / 10 s60 / 10 s100 / 10 s
/sendTemplateMessages30 / 10 s60 / 10 s100 / 10 s

Limites conforme publicados em Erros e limites de taxa, listados pelo nome do endpoint. A chamada em lote da versão 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, o status do chat, os chatbots e os segmentos personalizados exigem os planos Pro ou Business. A atualização de atributos para vários contatos de uma vez exige o plano Business. Disponibilidade de endpoints por plano. Para limites maiores, fale com o Wati sobre o seu caso de uso.

FAQ

Perguntas frequentes

A referência completa da API é pública. Leia a documentação

O que é o servidor Wati MCP?

Um servidor MCP remoto que permite que assistentes de IA usem o Wati. A documentação lista 58 ferramentas para modelos, campanhas, contatos, segmentos, conversas, tags e webhooks; a lista de ferramentas da sua sessão iniciada é o que conta. Conecte-se a https://mcp.wati.io/mcp ou a https://eu-mcp.wati.io/mcp para workspaces na UE.

Preciso de uma chave de API para usar o servidor Wati MCP?

Não. Seu cliente MCP faz seu login com OAuth, portanto, nenhuma chave de API vai na configuração ou na URL. Use a URL da UE se o seu workspace estiver na região da UE.

Quais canais meu agente pode usar por meio do MCP?

WhatsApp, com o conjunto completo de ferramentas. Respostas de texto de mensagens diretas (DM) do Instagram e Messenger também estão disponíveis, e o Messenger exige um login OAuth do Wati. As ferramentas de chatbot e comentários do Instagram estão sendo lançadas gradualmente.

Preciso saber programar?

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.

Quais são os limites de taxa da API?

As chamadas de contatos 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 código HTTP 429 com um cabeçalho Retry-After. Para limites maiores, entre em contato com o Wati.

Posso enviar mensagens para um cliente a qualquer momento?

No WhatsApp, textos de 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 número em uma caixa de entrada da equipe.

Quais endpoints estão no meu plano?

Os endpoints principais de mensagens, modelos e contatos estão em todos os planos. Atribuição de equipe, status de chat, chatbots e segmentos personalizados exigem os planos Pro ou Business. A documentação lista a disponibilidade dos endpoints por plano.

Sua primeira mensagem está a apenas uma solicitação de distância.

Comece gratuitamente, conecte seu número do WhatsApp no Wati e faça sua primeira chamada.