EntrarComeçar teste grátis
Meta Tech Provider

Referência das ferramentas MCP

O conector expõe mais de 30 ferramentas sobre todas as conexões de uma conta. A list_numbers vem primeiro para o WhatsApp, cujas ferramentas recebem o connection_id dela, e a list_social_accounts para os outros canais, cujas ferramentas recebem um account_id. Seis ficam bloqueadas quando a cobrança atrasa: as quatro do WhatsApp que agem sobre o mundo externo, a get_api_credentials, que devolve o token de acesso, e a create_connect_link. As outras continuam abertas.

O conector MCP do easyCoexistence se autentica por OAuth, sem chave de API para colar, e um único conector cobre todos os números e canais sociais conectados à conta.

30+

Ferramentas que o conector expõe.

6

Ferramentas bloqueadas quando a cobrança atrasa, incluindo a get_api_credentials, que devolve o token de acesso.

1

Login por OAuth, cobrindo todos os números da conta.

O que cada ferramenta faz?

Leitura: a list_numbers devolve os números conectados com status, classificação de qualidade e nível de mensagens, e é de onde toda outra chamada parte. A get_number_health devolve um retrato ao vivo da Meta mais a linha do tempo recente de monitoramento, eventos de webhook e checagens do poller juntos. A get_api_credentials devolve a URL base da Graph API, o id da WABA, o phone number id e, quando disponível, o token de acesso da própria conta.

Envio: a send_message manda texto livre dentro da janela de 24 horas, onde as respostas são gratuitas. A send_template manda um template aprovado, que é como se inicia uma conversa com alguém que não escreveu. A list_templates, a create_template e a get_template_status cobrem o ciclo de vida do template.

Conexão: a set_webhook_destination encaminha mensagens recebidas e ecos do app para o seu sistema, e passar null redefine isso. A get_connect_link devolve o link do painel e os passos para conectar um número novo. A get_docs devolve a documentação do produto em markdown.

Partner API, para software ou agências cujos próprios clientes conectam números: a get_partner_setup mostra a cobrança, a chave de API, a URL de eventos e o próximo passo. A create_api_key emite a chave da Partner API e mostra uma única vez, e não substitui uma chave existente sem confirmação explícita. A revoke_api_key revoga a chave, também após confirmação. A set_partner_events_url define para onde vão os eventos de status e devolve o segredo de assinatura uma única vez. A create_connect_link cria um link de conexão hospedado para um cliente, válido por 1 hora, igual ao POST /api/v1/connect-sessions.

Por que o connection_id importa?

Porque é ele que amarra uma instrução a um número específico, e um assistente não tem como adivinhar.

Toda ferramenta que age sobre um número recebe um connection_id, e a list_numbers é o único lugar de onde um deles vem. Na prática isso significa que um assistente a quem se pede para enviar uma mensagem vai chamar a list_numbers antes, e é por isso que a primeira requisição de uma sessão costuma ser mais lenta que as demais.

Também significa que uma conta com vários números fica sem ambiguidade por construção. Não existe número padrão nem seleção implícita, então uma instrução que não identifica de qual número se trata é perguntada, em vez de chutada.

O que acontece quando a cobrança atrasa?

Seis ferramentas ficam bloqueadas: send_message, send_template, create_template e set_webhook_destination, que agem sobre o mundo externo; get_api_credentials, porque devolve o token de acesso da conta, com o qual uma conta bloqueada poderia enviar direto pela Graph API; e create_connect_link, que conecta um número novo. Toda outra leitura continua disponível, assim como a configuração da Partner API: get_partner_setup, create_api_key, revoke_api_key e set_partner_events_url.

Isso é de propósito, e não um descuido. Uma conta que não consegue ver por que está bloqueada, ou não consegue checar se os números dela estão saudáveis, não tem caminho de volta a não ser um chamado de suporte. Essas mesmas leituras também são do que o monitoramento de saúde depende, então bloqueá-las desligaria o monitoramento no exato momento em que alguém mais precisa dele.

O efeito prático é que uma conta atrasada ainda responde perguntas sobre o próprio estado e segue monitorada. O que para é qualquer coisa que alcance um cliente.

Erros comuns

  • Esperar que o conector receba mensagens. O MCP é requisição e resposta; o tráfego de entrada precisa de um webhook.
  • Fixar um connection_id no código. Ele vem da list_numbers e não é um valor para anotar.
  • Achar que uma conta atrasada está totalmente fora do ar. As leituras e o monitoramento continuam de propósito, exceto as credenciais, que carregam o token que envia.
Fazendo isso com o EasyCoexistence

Um conector cobre todos os números de uma conta, autorizado por OAuth e sem chave para colar. A partir de R$ 29,90 por número por mês, caindo até R$ 3,90 conforme você adiciona números, com os primeiros 3 dias gratuitos.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Sou eu que escolho qual ferramenta chamar?

Não. Você pede em linguagem comum e o assistente escolhe, que é justamente para o que as descrições das ferramentas foram escritas.

Ele consegue ler as minhas conversas?

Não. As mensagens recebidas vão para o destino de webhook que você indicar. O conector lê o estado da conta e dos números.

A get_docs é útil?

Mais do que parece. Ela entrega ao assistente a nossa documentação em markdown, então respostas sobre as regras de Coexistência vêm dos nossos documentos, e não da memória.

Um conector cobre vários clientes?

Sim. Uma conta guarda quantos números você precisar e a list_numbers devolve todos eles.

Continue lendo

Pronto para começar?

Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.

Começar teste grátis

Verificado em