Referência das ferramentas MCP
O conector expõe onze ferramentas para todos os números de uma conta. list_numbers aparece primeiro porque todas as outras ferramentas recebem um connection_id obtido a partir dela. Quatro atuam no mundo exterior e ficam bloqueadas quando a faturação fica em atraso; as outras sete fazem leituras e continuam disponíveis.
Ferramentas expostas pelo conector.
Ferramentas bloqueadas quando a faturação fica em atraso. Todas as leituras continuam disponíveis.
Início de sessão OAuth, abrangendo todos os números da conta.
O que faz cada ferramenta?
Leitura: list_numbers devolve os números ligados, com o estado, a classificação de qualidade e o nível de mensagens, sendo o ponto de partida para todas as outras chamadas. get_number_health devolve em conjunto um instantâneo em tempo real da Meta, a cronologia recente da monitorização, os eventos do webhook e as verificações do poller. get_api_credentials devolve o URL base da Graph API, o WABA id, o phone number id e, quando disponível, o token de acesso da própria conta.
Envio: send_message envia texto livre dentro da janela de 24 horas, na qual as respostas são gratuitas. send_template envia um template aprovado, que permite iniciar uma conversa com alguém que ainda não escreveu. list_templates, create_template e get_template_status abrangem o ciclo de vida do template.
Ligação: set_webhook_destination encaminha mensagens recebidas e ecos da aplicação para o seu sistema; passar null repõe a definição anterior. get_connect_link devolve a ligação para o painel e os passos para ligar um novo número. get_docs devolve a documentação do produto em markdown.
Porque é importante o connection_id?
Porque é ele que liga uma instrução a um número específico, e um assistente não pode adivinhá-lo.
Todas as ferramentas que atuam sobre um número recebem um connection_id, e list_numbers é o único local onde este é obtido. Na prática, isto significa que, ao receber um pedido para enviar uma mensagem, o assistente chama primeiro list_numbers, razão pela qual o primeiro pedido de uma sessão é muitas vezes mais lento do que os restantes.
Isto também significa que uma conta com vários números não deixa margem para ambiguidades. Não existe um número predefinido nem uma seleção implícita, por isso uma instrução que não identifique o número fica por esclarecer, em vez de ser adivinhada.
O que acontece quando a faturação fica em atraso?
As quatro ferramentas que atuam no mundo exterior ficam bloqueadas: send_message, send_template, create_template e set_webhook_destination. Tudo o que faz leituras continua disponível.
Isto é deliberado, não uma falha. Uma conta que não consiga ver porque está bloqueada, ou verificar se os seus números estão em boas condições, fica sem alternativa além de contactar o apoio ao cliente. Essas mesmas leituras são também aquilo de que depende a monitorização da saúde, pelo que bloqueá-las desligaria a monitorização precisamente quando alguém mais precisa dela.
Na prática, uma conta com a faturação em atraso continua a responder a perguntas sobre o seu próprio estado e continua a ser monitorizada. O que fica impedido é tudo o que chega a um cliente.
Erros comuns
- Esperar que o conector receba mensagens. O MCP funciona por pedido e resposta; o tráfego recebido precisa de um webhook.
- Fixar um connection_id no código. O valor vem de list_numbers e não deve ser anotado.
- Assumir que uma conta com a faturação em atraso fica totalmente offline. As leituras e a monitorização continuam de propósito.
Um conector abrange todos os números de uma conta, com autorização OAuth e sem chave para colar. A partir de US$ 9 por número por mês, descendo para US$ 2 em volume, com os primeiros 7 dias gratuitos.
Perguntas frequentes
Tenho de escolher qual ferramenta chamar?
Não. Faz o pedido em linguagem natural e o assistente escolhe a ferramenta. É para isso que servem as descrições das ferramentas.
Pode ler as minhas conversas?
Não. As mensagens recebidas são encaminhadas para o destino do webhook que indicar. O conector lê o estado da conta e dos números.
get_docs é útil?
Mais do que parece. Fornece ao assistente a nossa documentação em markdown, para que as respostas sobre as regras de Coexistence venham da nossa documentação, e não da memória.
Um conector abrange vários clientes?
Sim. Uma conta pode ter tantos números quantos forem necessários e list_numbers devolve-os todos.
Continue a ler
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.
Começar período experimental gratuitoVerificado em