Difunde la alegría navideña con agentes de IA y herramientas de mensajería MCP de Vonage

Automatiza la mensajería personalizada a través de WhatsApp, RCS y SMS usando agentes de IA y el servidor MCP de Vonage.

Introducción

A medida que su empresa crece, la mensajería de talla única no es suficiente. Algunos usuarios prefieren SMS. Otros esperan WhatsApp. Y con la creciente adopción de RCS, el soporte de múltiples canales se está convirtiendo en algo esencial. ¿Cuál es el reto? Personalizar la mensajería entre canales, idiomas y preferencias sin crear y mantener una infraestructura compleja.

¿Puedes adivinar la solución? IA Aprovechando asistentes de IA como Windsurf o Cursor dentro de tu IDE, puedes delegar en un agente tareas de comunicación repetitivas y con mucha lógica. Es un caso de uso ideal para la mensajería multicanal asistida por IA.

En este tutorial, aprenderás a integrar un agente de inteligencia artificial con el servidor MCP de Vonage para enviar mensajes festivos personalizados y compatibles con el canal según las preferencias del contacto. Con un simple archivo CSV, configurarás la IA para que lea las preferencias de mensajería, elija el canal de entrega correcto, maneje la lógica de devolución e incluso localice los saludos según el idioma. Ya se trate de Feliz Hanukkah o Feliz Navidadeste flujo de trabajo le permite ampliar su alcance sin tener que escribir una aplicación completa.

Screen recording of an AI agent in Windsurf reading a CSV file of holiday contacts and generating personalized messages using the Vonage Tooling MCP Server, with some data fields obscured for privacy.

Comprender a nuestro agente de IA

Si eres nuevo en el Protocolo de contexto de modelo (MCP) o en los agentes de IA, echa un vistazo a nuestro post de introducción: Presentación del MCP: la IA se une a las comunicaciones programables con Vonage

Un repaso rápido: Los servidores MCP proporcionan a los agentes de IA (como Windsurf o Claude) la capacidad de descubrir y utilizar de forma segura las funcionalidades de los desarrolladores, denominadas herramientassin tener que codificar cada llamada a la API. En lugar de escribir la lógica de integración desde cero, el servidor expone capacidades como Enviar un SMS o Comprobar mi saldoy el agente decide cómo y cuándo utilizarlas.

Este tutorial se basa en el Servidor MCP de herramientas de Vonageque expone un conjunto de herramientas de Vonage a las que tu agente puede acceder directamente desde tu IDE. Este post utiliza estas cinco herramientas de mensajería:

• whatsapp-send-text

• whatsapp-send-text-with-sms-failover

• rcs-send-text

• rcs-send-text-with-sms-failover

• sms

El agente de IA utiliza estas herramientas para leer las preferencias de un contacto, elegir el canal adecuado (por ejemplo, WhatsApp en Europa, SMS en EE.UU.) y enviar un mensaje personalizado. Si falla el canal preferido, el servidor recurre automáticamente al SMS mediante una lógica de conmutación por error integrada.

Estas herramientas envuelven una función de mensajería unificada que da formato a los números de teléfono, comprueba las credenciales y dirige el mensaje al canal adecuado. Si un canal preferido falla, puede recurrir automáticamente a SMS.

Cada canal tiene su propia envoltura ligera sendWhatsAppText, sendRCSText, sendSMSText), y cada uno está registrado como una herramienta MCP que el agente puede descubrir y utilizar directamente.

Ahora vamos a conectar a nuestro agente para que utilice estas herramientas.

Ver toda la lógica >> Compruebe sendChannelMessage() y los registros de herramientas en index.ts.

Requisitos previos

• Cuenta de WhatsApp BusinessNecesitarás tener una cuenta de WhatsApp Business habilitada en tu cuenta API de Vonage.

• Un registrado Agente de RCS Business Messaging (RBM)

• Un teléfono con RCS activado para las pruebas

• IDE con capacidades de agente de IA como Código VS, Cursoro Windsurf.

  • Este tutorial utilizará Windsurf.

Paso 1: Crear una aplicación de Vonage con RCS y WhatsApp

Podrías pensar que nuestro agente puede crear una aplicación de Vonage. Lamentablemente, todavía no. Pero nuestro servidor es de código abierto, ¡así que puedes ayudarnos y agregar esa funcionalidad a través de un PR! Por ahora tendrás que crear tu aplicación a través de Vonage Dashboard o CLI.

Requisitos para su aplicación

1. Habilite las funciones de Mensajes. Puede añadir URL ficticias para los webhooks.

2. Genere una clave pública y privada, que utilizará más adelante para configurar su servidor MCP.

3. Vincula tus cuentas de WhatsApp y RCS

Screenshot from the Vonage API Dashboard showing RCS and WhatsApp accounts linked to an application under the 'Link external accounts' tab, with options to unlink each.

Paso 2: Crear un CSV de contactos

Lo bueno de los IDE-Integrated AI Assistants es que pueden leer cualquier archivo que esté abierto. Para aplicaciones de producción, querrás crear un proyecto completo con algún tipo de base de datos. Para este divertido caso de uso, simplemente crea un simple CSV y ábrelo en Windsurf:

touch holiday_contacts.csv
windsurf holiday_contacts.csv

Dentro del CSV, añade contactos con sus números de teléfono, preferencias de comunicación y vacaciones preferidas. También puedes añadir más contexto para cada contacto para ayudar al Agente de IA a generar un mensaje más personalizado, yo he incluido el idioma preferido.

Aquí está un ejemplo de CSV, reemplazar con números de teléfono que usted puede probar:

name,phone,rcs?,whatsapp?,preferred_holiday,preferred_language
Boris Shomris,11233214567,no,yes,hanukkah,hebrew
Alberto Roberto,34123321456,yes,yes,christmas,spanish
Henry Mulenberry,11233214567,yes,no,new_year,english
Sasha Pasha,44123321457,no,yes,kwanza,english
Tenzin Kenzin,86123321458,yes,no,bodhi_day,hindi

Paso 3: Configure su servidor MCP

Ahora necesitarás darle acceso a Cascade en Windsurf (o a tu agente de Cursor/VS Code) al servidor de Vonage Tooling. Abre el panel de Cascade (opción+comando+B). Haz clic en el icono del plugin y, a continuación, en el icono de configuración. También puedes abrir el mcp_config.json directamente. Por defecto está en Users>{your_user}>.codeium>windsurf>mcp.json.

Allí, agrega el servidor Vonage Tooling a tu objeto mcpServers:

{
  "mcpServers": {
    "vonage-tooling": {
      "command": "npx",
      "args": ["-y", "@vonage/vonage-mcp-server-api-bindings"],
      "env": {
        "VONAGE_API_KEY": "your_api_key_here",
        "VONAGE_API_SECRET": "your_api_secret_here", 
        "VONAGE_APPLICATION_ID": "your_application_id_here",
        "VONAGE_PRIVATE_KEY64": "your_private_key_base64_here",
        "VONAGE_WHATSAPP_NUMBER": "+1234567890",
        "RCS_SENDER_ID": "YourBrandName",
        "VONAGE_VIRTUAL_NUMBER": "+1234567890"
      }
    }
  }
}

• Encuentre su API_KEY y API_SECRET en la sección Configuración de API en el panel de Vonage.

• En APPLICATION_ID, VONAGE_WHATSAPP_NUMBERy RCS_SENDER_ID se encuentran en la página de la aplicación creada en el paso 1. Puede reutilizar el valor VONAGE_WHATSAPP_NUMBER para el valor VONAGE_VIRTUAL_NUMBER que se utiliza para enviar SMS.

• La Clave Privada que generamos antes aún no está en base64. Tendrás que convertirla usando la herramienta de Dwane Hemming Clave privada a variable de entorno de Dwane Hemming y luego pegarla en VONAGE_PRIVATE_KEY64.

Después de haber añadido todas las variables de entorno, reinicia Windsurf. Cuando abras Cascade deberías ver que el servidor Vonage-Tooling está disponible con herramientas. ¡Qué guay! Puedes ver que también tengo el Servidor de documentación de Vonage disponible.

Confirmation in Windsurf that the Vonage Tooling MCP Server is active and connected, as seen in the Cascade panel.

Paso 4: Pruebe con su agente de IA

Una vez que tengas tu CSV de contactos listo y le hayas dado a Cascade acceso a las herramientas de Vonage, ¡eso es todo! Ahora es el momento de experimentar con los mensajes y ver lo atractivo, sincero o divertido que puede ser su agente de IA.

Example of a personalized holiday greeting sent via WhatsApp using the Vonage MCP Tooling Server, customized with name and Spanish-language message content.

Prueba con diferentes solicitudes para comprobar su comportamiento. Por ejemplo, tenía un usuario de prueba que tenía tanto RCS como WhatsApp configurados como sí en el CSV, pero sólo su número RCS funcionó realmente. El comportamiento esperado debería ser "prueba RCS, luego prueba WhatsApp, y sólo entonces envía el SMS de conmutación por error". Sin embargo, el siguiente mensaje fue inmediatamente WhatsApp -> SMS failover.

Send a personalized holiday greeting for my
friends in the holiday_contracts.csv. RCS and
WhatsApp are preferred over SMS but if RCS or
WhatsApp don't work you can failover to SMS.
Use the preferences you find in the csv

Quizá añadir una columna que clasifique las preferencias de comunicación del usuario habría dado al agente el contexto suficiente para hacerlo correctamente. Experimenta y cuéntanoslo en nuestra Community Slack.

Conclusión

¿Ha tenido problemas para configurar su agente? ¿Quizás quieres crear un chatbot dedicado con funcionalidad de aplicación completa para trabajar fuera de tu IDE? Si es así, consulta Cómo agregar API de Vonage a tu agente de IA. ¡Ese chatbot fue la inspiración para este post! Todo lo que tuve que hacer fue añadir las herramientas deseadas a nuestro servidor MCP.

¿Quieres ver más herramientas en el servidor? ¡Es de código abierto! Así que construye el futuro que buscas. Daré más detalles en una futura entrada del blog, pero básicamente... ¡nos encantaría ver algunos PRs!