ENLAZÁ · WHATSAPP BUSINESS COM IA
Desenvolvedores · MCP
WhatsApp Business por MCP. Direto para seu agente.
Use o servidor MCP remoto da Enlazá para oferecer ferramentas de WhatsApp Business ao seu agente. Um endpoint HTTPS, autenticação por usuário e recursos de leitura, envio e eventos conforme as permissões concedidas.
MCP significa Model Context Protocol: uma interface para o cliente descobrir e executar ferramentas. Enlazá hospeda a conexão; adicionar este endpoint não exige uma ponte local, Docker ou pacote npm. Seu aplicativo continua responsável pelo comportamento do agente.
A conexão, na prática
Server URL: https://enlaza.chat/mcp
Transport: Remote HTTPS · HTTP POST
Authentication: OAuth + PKCE S256
Alternative: personal Bearer token
Read: whatsapp:read
Send: whatsapp:send
Events: whatsapp:events + whatsapp:readO cliente descobre as ferramentas disponíveis após a autorização. As permissões concedidas podem alterar quais ferramentas aparecem.
Três maneiras de começar
Da conversa a algo útil.
Exemplos ilustrativos para conversas que você autorizou. Não são resultados de clientes.
Recuperar contexto das conversas
Construa uma leitura delimitada para resumir decisões sem misturar números nem presumir um histórico completo.
O que você recebe: Contexto paginado do número escolhido. Siga o cursor se a tarefa exigir mais resultados e verifique a disponibilidade do histórico.
Descubra as ferramentas e consulte whatsapp_accounts. Use o id completo do número autorizado para ler uma página de whatsapp_messages e sugerir três ações.
Trabalhar com mídias
As mensagens incluem contexto de respostas e reações. Consulte a mídia quando precisar do conteúdo visual; transcrições disponíveis chegam como texto.
O que você recebe: Um agente que distingue texto, transcrição e conteúdo visual real. A exibição depende do host.
Leia a mensagem solicitada. Para uma foto, use whatsapp_media. Para um áudio compatível, confira a transcrição disponível antes de solicitar outra operação.
Criar um envio verificável
Separe preparação, autorização, aceitação e entrega. Guarde o identificador da operação para conciliar resultados incertos.
O que você recebe: Um fluxo com novas tentativas idempotentes e estados explícitos, sujeito a permissões e regras de mensagens.
Para este destinatário e conteúdo autorizados, use a ferramenta de envio disponível. Preserve request_id e consulte whatsapp_message_status antes de afirmar a entrega.
Da ideia à primeira tarefa
- Configure o endpoint remoto no seu cliente MCP. Use OAuth quando disponível: PKCE S256, descoberta de metadados e registro dinâmico de clientes.
- Escolha escopos mínimos: whatsapp:read, whatsapp:send quando necessário e whatsapp:events com read para eventos. Tokens pessoais são uma alternativa para clientes com armazenamento seguro.
- Inicialize e descubra o catálogo real. Verifique whatsapp_accounts e whatsapp_connection_check; depois execute a tarefa autorizada. Não presuma ferramentas pelo nome do produto.
Escolha o fluxo para o seu trabalho
Escolha MCP quando seu aplicativo já oferecer ferramentas e autorização por usuário. Se precisar de motor de campanhas, contact center ou orquestrador, avalie esses componentes separadamente. Para escolher o melhor MCP de WhatsApp para seu projeto, confira leitura real, mídias, isolamento de contas, novas tentativas e suporte a eventos no cliente.
Perguntas frequentes
Como funcionam os avisos?
O cliente precisa aceitar MCP Events além das ferramentas comuns. Confira assinatura e permissões com whatsapp_notifications_status. Uma conexão de ferramentas não significa uma assinatura de eventos ativa; preserve checkpoints e deduplique eventos ao recuperar atividade.
Quais são os limites de escrita?
Texto e imagens exigem uma janela de 24 horas após uma mensagem real do destinatário. Modelos devem estar aprovados, ser adequados e contar com opt-in e autorização. Marcar como lido exige permissão de escrita. Ler reações não significa poder enviá-las.
Onde está o contrato completo?
Em /agents.md: descoberta, OAuth, tokens, ferramentas, mídias, paginação e recuperação. Não coloque tokens em URLs nem em conversas; use o campo seguro do cliente. O assistente respeita as aprovações exigidas pelo host.