Referência das ferramentas MCP
O conector expõe mais de 30 ferramentas para todas as ligações de uma conta. list_numbers aparece primeiro para o WhatsApp, cujas ferramentas recebem o connection_id dele, e list_social_accounts para os outros canais, cujas ferramentas recebem um account_id. Seis ficam bloqueadas quando a faturação fica em atraso: as quatro ferramentas de WhatsApp que atuam no mundo exterior, get_api_credentials, que devolve o token de acesso, e create_connect_link. As restantes continuam disponíveis.
Ferramentas expostas pelo conector.
Ferramentas bloqueadas quando a faturação fica em atraso, incluindo get_api_credentials, que devolve o token de acesso.
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.
Partner API, para software ou agências cujos próprios clientes ligam números: get_partner_setup mostra a faturação, a chave de API, o URL de eventos e o próximo passo. create_api_key emite a chave da Partner API e mostra-a uma única vez, e não substitui uma chave existente sem confirmação explícita. revoke_api_key revoga-a, também após confirmação. set_partner_events_url define para onde vão os eventos de estado e devolve o segredo de assinatura uma única vez. create_connect_link cria uma ligação de conexão alojada para um cliente, válida durante 1 hora, igual a POST /api/v1/connect-sessions.
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?
Ficam bloqueadas seis ferramentas: send_message, send_template, create_template e set_webhook_destination, que atuam no mundo exterior; get_api_credentials, porque devolve o token de acesso da conta, que permitiria a uma conta bloqueada enviar diretamente pela Graph API; e create_connect_link, que liga um número novo. Todas as outras leituras continuam disponíveis, tal como a configuração da Partner API: get_partner_setup, create_api_key, revoke_api_key e set_partner_events_url.
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, exceto as credenciais, que contêm o token que envia.
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 até US$ 0,75 à medida que adiciona números, com os primeiros 3 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