Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

Dê a um assistente de IAum número WhatsApp real.

Um servidor MCP permite que o Claude, o ChatGPT ou o Cursor usem o WhatsApp diretamente: listar os seus números, verificar o estado de cada um, enviar mensagens e templates e apontar webhooks para os seus próprios sistemas. O nosso funciona na Cloud API oficial da Meta, por isso o número para o qual os seus clientes já enviam mensagens nunca fica em risco.

Iniciar teste gratuito3 dias gratuitos. Nada é cobrado até ao fim do período experimental.
Adicione o conector
{
  "mcpServers": {
    "easycoexistence": {
      "url": "https://easycoexistence.com/api/mcp"
    }
  }
}
Início de sessão por OAuthNada para instalarTodos os números da conta
Sem guardar mensagens por defeitoAplicação Business + Cloud APIMCP para Claude e ChatGPTPronto em 2 minutos

A que se liga realmente o conector

Um único servidor remoto, acedido por OAuth, que chama a Cloud API documentada da Meta num número que continua ativo na app do WhatsApp Business. Não há sessão mantida em lado algum e nada é executado na sua máquina.

  1. 1
    O seu assistenteClaude, ChatGPT, Cursor ou Claude Code, via MCP
  2. 2
    easycoexistence.com/api/mcpRemoto, autorizado por OAuth. Nenhuma chave é colada em lado algum
  3. 3
    Meta Cloud APIOs endpoints documentados da Graph, com o token da própria conta
  4. 4
    O número da empresaLigado através da Coexistência, com a app a continuar a funcionar no telemóvel

A alternativa seguida pela maior parte da automação de WhatsApp é iniciar sessão como dispositivo ligado e controlar a sessão do WhatsApp Web. Isso viola os termos do WhatsApp, e a Meta deteta-o pela forma do tráfego e não pelo código que o envia, razão pela qual uma promessa de evitar bloqueios descreve algo que o fornecedor não consegue controlar. Nada aqui usa esse mecanismo.

Como instalar

Um único endpoint remoto, o mesmo para todos os números da conta. Não há pacote para instalar nem chave para gerar: cada cliente inicia sessão com OAuth na primeira vez que chama uma ferramenta.

ClaudeDefinições → Conectores → Adicionar conector personalizado
  1. Abra as Definições e vá a Conectores.
  2. Escolha Adicionar conector personalizado e cole o endpoint abaixo.
  3. Guarde e peça ao Claude que liste os seus números. Na primeira vez, abre um início de sessão.
URL do conector
https://easycoexistence.com/api/mcp
ChatGPTDefinições → Conectores → Avançadas → Modo de programador
  1. Abra as Definições, vá a Conectores, depois a Avançadas, e ative o Modo de programador.
  2. Adicione um conector com o endpoint abaixo.
  3. Inicie uma conversa e peça-lhe que liste os seus números para acionar o início de sessão.
URL do conector
https://easycoexistence.com/api/mcp
Claude CodeUm comando, uma vez por máquina
  1. Execute o comando abaixo em qualquer terminal.
  2. Execute /mcp no Claude Code e autentique-se.
  3. As ferramentas ficam disponíveis em todas as sessões a partir daí.
Terminal
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp
CursorDefinições → MCP, ou ~/.cursor/mcp.json
  1. Abra as Definições e encontre a secção MCP.
  2. Adicione um servidor com a configuração abaixo.
  3. Recarregue e peça ao Cursor que liste os seus números.
mcp.json
{
  "mcpServers": {
    "easycoexistence": {
      "url": "https://easycoexistence.com/api/mcp"
    }
  }
}

Ligar um número é um passo à parte, feito uma única vez e que precisa de um navegador, porque a integração da Meta usa uma janela pop-up própria e a leitura de um QR. get_connect_link devolve essa ligação se preferir que seja o assistente a entregá-la.

Regras que as ferramentas impõem, para que o assistente não as aprenda da pior maneira

Texto livre apenas dentro das 24 horas

send_message funciona quando o destinatário enviou uma mensagem para o número nas últimas 24 horas. Essas respostas são gratuitas. Fora desse período, send_template com um template aprovado é a única coisa que é entregue, e a descrição da ferramenta indica-o, por isso o assistente escolhe a ferramenta certa sem que ninguém lho diga.

Na Coexistência, os templates são apenas por API

A app do telemóvel não consegue enviar um template num número em Coexistência. Tudo o que é agendado, transacional ou fora do período tem de passar pela API, o que é grande parte da razão pela qual se liga um número.

A Meta cobra o marketing na sua própria conta

Os envios de marketing são cobrados pela Meta no método de pagamento da WhatsApp Business Account, configurado no WhatsApp Manager. Nunca passa por nós e não conseguimos adicionar um cartão através da API.

Um destino de webhook tem de concluir o handshake da Meta

HTTPS, e num GET com hub.mode=subscribe e o seu hub.verify_token o endpoint tem de devolver o hub.challenge. Validamos antes da chamada, por isso um URL errado falha de imediato em vez de parecer ligado.

As dezasseis ferramentas de WhatsApp, e para que serve realmente cada uma

Um único conector expõe-nas em todos os números da conta, juntamente com as ferramentas de outros canais. list_numbers vem primeiro porque todas as outras ferramentas de WhatsApp recebem dela um connection_id.

LeituraO que existe, e se está em bom estado
  • list_numbersNúmeros ligados com o estado, a classificação de qualidade e o nível de mensagens. O ponto de partida para tudo o resto.
  • get_number_healthUm retrato em direto da Meta e a cronologia recente da monitorização: eventos de webhook e verificações periódicas em conjunto.
  • get_api_credentialsURL base da Graph API, WABA id, phone number id e o token de acesso da própria conta, quando existir um disponível.
EnvioChegar a um cliente, dentro ou fora do período
  • send_messageTexto livre, e apenas dentro da janela de atendimento de 24 horas. As respostas dentro desse período são gratuitas.
  • send_templateÉ assim que se inicia uma conversa com alguém que não escreveu primeiro.
  • list_templatesOs templates da conta com o respetivo estado de revisão.
  • create_templateSubmete à revisão da Meta. UTILITY, MARKETING ou AUTHENTICATION, com variáveis do tipo {{1}} que precisam de valores de exemplo.
  • get_template_statusAPPROVED, PENDING ou REJECTED, pelo nome do template.
LigaçãoO par que faz disto mais do que um brinquedo de conversação
  • set_webhook_destinationEncaminha as mensagens recebidas e os ecos da app do telemóvel diretamente da Meta para o seu sistema. Passe null para o repor.
  • get_connect_linkDevolve a ligação do painel e os passos para ligar um número novo, uma vez que a integração precisa de um navegador.
  • get_docsA documentação completa do produto em markdown, para que o assistente responda com base na nossa documentação em vez de adivinhar.
Partner APIPermita que os seus próprios clientes liguem números a partir do seu software
  • get_partner_setupEm que ponto está a configuração da Partner API: faturação, chave de API, URL de eventos e o próximo passo.
  • create_api_keyGera a chave da Partner API e mostra-a uma única vez. Só substitui uma chave existente se confirmar.
  • revoke_api_keyRevoga a chave da Partner API depois de confirmar. A partir daí, todos os pedidos feitos com ela falham.
  • set_partner_events_urlDefine para onde vão os eventos de estado da ligação e devolve o segredo de assinatura, mostrado uma única vez.
  • create_connect_linkCria uma ligação de conexão alojada para um dos seus clientes, válida durante 1 hora. O número é faturado na sua conta.

O que continua a funcionar quando o pagamento falha

Ficam bloqueadas as ferramentas que atuam no mundo exterior e também a get_api_credentials, porque entrega o token com que se envia. A leitura da saúde e do estado mantém-se aberta, de propósito.

Mantém-se aberta
  • list_numbers
  • get_number_health
  • get_template_status
  • list_templates
  • get_connect_link
  • get_docs
  • get_partner_setup
  • create_api_key
  • revoke_api_key
  • set_partner_events_url
Bloqueada
  • send_message
  • send_template
  • create_template
  • set_webhook_destination
  • get_api_credentials
  • create_connect_link

Uma conta que não consegue ver porque está bloqueada, ou não consegue verificar se os seus números estão em bom estado, não tem outro caminho de volta senão um pedido de apoio. Essas duas leituras são também aquilo de que a própria monitorização do estado depende.

O par que importa se presta serviços a outras empresas

get_connect_link devolve a ligação que um cliente abre para associar o seu próprio número, e set_webhook_destination aponta esse número para o seu sistema no momento em que fica ligado. Em conjunto, permitem que um agente integre um cliente do início ao fim sem que ninguém abra um painel.

Uma conta comporta tantos números quantos forem necessários, cada um faturado separadamente, e list_numbers devolve-os todos com o connection_id que todas as outras ferramentas recebem.

30+ tools

Ferramentas de leitura, envio, templates, ligação, documentação e Partner API, todas listadas abaixo.

20 msg/s

Throughput de envio fixo para um número de Coexistência, definido pela Meta. Não pode ser aumentado por nós nem por si.

24 hours

Durante quanto tempo a resposta de um cliente mantém a sessão aberta. Fora desse período, só pode ser enviado um template aprovado.

0 installs

O servidor é remoto, por isso nada é executado na sua máquina e nenhuma sessão fica mantida em lado algum.

Perguntas frequentes

O número do meu cliente pode ser bloqueado por causa disto?

Não. Esta é a Cloud API oficial da Meta, acedida através da funcionalidade Coexistência da própria Meta. O risco de bloqueio vem dos gateways não oficiais que iniciam sessão como um dispositivo ligado, um mecanismo completamente diferente.

Com que assistentes funciona o conector?

Qualquer um que fale MCP por HTTP com OAuth: Claude, ChatGPT, Cursor, Claude Code e Codex atualmente. É um endpoint remoto único, por isso nada é executado na sua máquina.

As minhas conversas passam pelos vossos servidores?

Não por predefinição. As mensagens recebidas são encaminhadas da Meta diretamente para o webhook que indicar, e não armazenamos o conteúdo das conversas. Mantemos apenas a conta, o estado do número e as credenciais necessárias para executar e monitorizar a ligação.

Posso usar um conector para vários clientes?

Sim. Uma conta pode conter tantos números quantos forem necessários, cada um faturado como uma ligação própria, e o conector lista-os todos. Não há qualquer restrição à utilização para empresas que presta serviço.

Pronto para começar?

Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.

Iniciar teste gratuito3 dias gratuitos. Nada é cobrado até ao fim do período experimental.

Continue a ler