mcp-tools-reference | Referência das ferramentas MCP
O conector expõe onze ferramentas sobre todos os números de uma conta. A list_numbers vem primeiro porque toda outra ferramenta recebe um connection_id dela. Quatro agem sobre o mundo externo e ficam bloqueadas quando a cobrança atrasa; as outras sete só leem e continuam abertas.
Ferramentas que o conector expõe.
Ferramentas bloqueadas quando a cobrança atrasa. Toda leitura continua disponível.
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.
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?
As quatro ferramentas que agem sobre o mundo externo ficam bloqueadas: send_message, send_template, create_template e set_webhook_destination. Tudo que apenas lê continua disponível.
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.
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 para R$ 7,90 no volume, com os primeiros 7 dias gratuitos.
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átisVerificado em