mcp-tools-reference | Referencia de las herramientas MCP
El conector expone once herramientas sobre todos los números de una cuenta. list_numbers va primero porque cada una de las demás recibe un connection_id de ella. Cuatro actúan sobre el mundo exterior y se bloquean cuando el cobro se atrasa; las otras siete solo leen y siguen abiertas.
Herramientas que expone el conector.
Herramientas bloqueadas cuando el cobro se atrasa. Toda lectura sigue disponible.
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.
¿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?
Las cuatro herramientas que actúan sobre el mundo exterior quedan bloqueadas: send_message, send_template, create_template y set_webhook_destination. Todo lo que solo lee sigue disponible.
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.
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 a US$ 2 con volumen, con los primeros 7 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 gratisVerificado el