Iniciar sesiónEmpezar prueba gratis
Meta Tech Provider

Referencia de las herramientas MCP

El conector expone más de 30 herramientas sobre todas las conexiones de una cuenta. list_numbers va primero para WhatsApp, cuyas herramientas reciben su connection_id, y list_social_accounts para los demás canales, cuyas herramientas reciben un account_id. Seis se bloquean cuando el cobro se atrasa: las cuatro herramientas de WhatsApp que actúan sobre el mundo exterior, get_api_credentials, que devuelve el token de acceso, y create_connect_link. Las demás siguen abiertas.

El conector MCP de easyCoexistence inicia sesión con OAuth, sin clave de API que pegar, y un solo conector cubre todos los números y canales sociales conectados a la cuenta.

30+

Herramientas que expone el conector.

6

Herramientas bloqueadas cuando el cobro se atrasa, incluida get_api_credentials, que devuelve el token de acceso.

1

Inicio de sesión con OAuth, que cubre todos los números de la cuenta.

¿Qué hace cada herramienta?

Lectura: list_numbers devuelve los números conectados con estado, calificación de calidad y nivel de mensajería, y es donde empieza cada una de las demás llamadas. get_number_health devuelve una foto en vivo de Meta más la línea de tiempo reciente de monitoreo, eventos de webhook y revisiones del poller juntos. get_api_credentials devuelve la URL base de la Graph API, el id de la WABA, el phone number id y, cuando está disponible, el token de acceso de la propia cuenta.

Envío: send_message manda texto libre dentro de la ventana de 24 horas, donde las respuestas son gratuitas. send_template manda una plantilla aprobada, que es como se inicia una conversación con alguien que no ha escrito. list_templates, create_template y get_template_status cubren el ciclo de vida de la plantilla.

Cableado: set_webhook_destination enruta los mensajes entrantes y los ecos de la app hacia tu sistema, y pasar null lo restablece. get_connect_link devuelve el enlace del panel y los pasos para conectar un número nuevo. get_docs devuelve la documentación del producto en markdown.

Partner API, para software o agencias cuyos propios clientes conectan números: get_partner_setup muestra el estado del cobro, la clave de API, la URL de eventos y el siguiente paso. create_api_key emite la clave de la Partner API y la muestra una sola vez, y no reemplaza una clave existente sin confirmación explícita. revoke_api_key la revoca, también tras confirmación. set_partner_events_url define adónde van los eventos de estado y devuelve el secreto de firma una sola vez. create_connect_link crea un enlace de conexión alojado para un cliente, válido 1 hora, igual que POST /api/v1/connect-sessions.

¿Por qué importa el connection_id?

Porque es lo que ata una instrucción a un número concreto, y un asistente no puede adivinarlo.

Cada herramienta que actúa sobre un número recibe un connection_id, y list_numbers es el único lugar del que sale uno. En la práctica eso significa que a un asistente al que se le pide enviar un mensaje llamará antes a list_numbers, y por eso la primera petición de una sesión suele ser más lenta que el resto.

También significa que una cuenta con varios números queda sin ambigüedad por construcción. No hay número por defecto ni selección implícita, así que una instrucción que no identifica de qué número habla se pregunta, en lugar de adivinarse.

¿Qué pasa cuando el cobro se atrasa?

Seis herramientas quedan bloqueadas: send_message, send_template, create_template y set_webhook_destination, que actúan sobre el mundo exterior; get_api_credentials, porque devuelve el token de acceso de la cuenta, con el que una cuenta bloqueada podría enviar directamente por la Graph API; y create_connect_link, que conecta un número nuevo. Toda otra lectura sigue disponible, igual que la configuración de la Partner API: get_partner_setup, create_api_key, revoke_api_key y set_partner_events_url.

Esto es deliberado y no un descuido. Una cuenta que no puede ver por qué está bloqueada, o no puede revisar si sus números están sanos, no tiene camino de vuelta salvo un ticket de soporte. Esas mismas lecturas son además de lo que depende el monitoreo de salud, así que bloquearlas apagaría el monitoreo justo en el momento en que alguien más lo necesita.

El efecto práctico es que una cuenta atrasada sigue respondiendo preguntas sobre su propio estado y sigue monitoreada. Lo que se detiene es cualquier cosa que alcance a un cliente.

Errores comunes

  • Esperar que el conector reciba mensajes. MCP es petición y respuesta; el tráfico entrante necesita un webhook.
  • Dejar fijo un connection_id en el código. Sale de list_numbers y no es un valor para anotar.
  • Suponer que una cuenta atrasada está del todo fuera de línea. Las lecturas y el monitoreo continúan a propósito, salvo las credenciales, que llevan el token con el que se envía.
Hacerlo con EasyCoexistence

Un conector cubre todos los números de una cuenta, autorizado por OAuth y sin ninguna clave que pegar. Desde US$ 9 por número por mes, bajando hasta US$ 0,75 a medida que añades números, con los primeros 3 días gratis.

Preguntas frecuentes

¿Elijo yo qué herramienta llamar?

No. Tú pides en lenguaje común y el asistente elige, que es justo para lo que están escritas las descripciones de las herramientas.

¿Puede leer mis conversaciones?

No. Los mensajes entrantes se enrutan al destino de webhook que tú indiques. El conector lee el estado de la cuenta y de los números.

¿get_docs es útil?

Más de lo que parece. Le entrega al asistente nuestra documentación en markdown, así que las respuestas sobre las reglas de Coexistencia vienen de nuestros documentos y no de la memoria.

¿Un conector cubre a varios clientes?

Sí. Una cuenta guarda tantos números como necesites y list_numbers los devuelve todos.

Sigue leyendo

¿Listo para empezar?

Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.

Empezar prueba gratis

Verificado el