Skip to main content
El servidor MCP de iZap permite que un agente de IA opere tu negocio de WhatsApp de punta a punta, no solo enviar un mensaje. iZap es un BSP oficial de WhatsApp que también controla la capa de aplicación (CRM, chatbots, pedidos, analítica), y este servidor expone esa capa a cualquier agente mediante Streamable HTTP en {origin}/mcp: consulta analítica, gestiona tus asistentes de IA y envía mensajes y transmisiones. La misma lógica de negocio y la misma autenticación que la API REST. Cada herramienta está limitada a tu negocio mediante OAuth y lleva indicaciones de solo lectura / destructiva, para que el agente sepa qué es seguro llamar antes de hacerlo. Los títulos y las descripciones están disponibles en inglés y portugués. Conecta Claude, ChatGPT o Cursor con un clic.

¿Eligiendo herramientas de WhatsApp para agentes de IA?

Cómo se compara iZap con las APIs solo de transporte (Twilio, Cloud API, 360dialog) y con las bandejas de entrada sin código, y cuándo conviene cada una.

Conecta

La autenticación es OAuth 2.0 (los clientes interactivos la inician automáticamente) o un JWT Bearer para código de servidor a servidor. Regístralo como servidor MCP HTTP remoto:

Agrégalo a tu cliente de IA

Apunta cualquier cliente compatible con MCP a la URL de arriba; los clientes interactivos hacen el login OAuth por ti.
Con un clic: abre Agregar iZap a Cursor y confirma la instalación, o pega este enlace en tu navegador:
Manual: agrégalo a ~/.cursor/mcp.json (global) o a .cursor/mcp.json (por proyecto):
Cambia el host por la URL de staging (https://api-staging.izap.ai/mcp) para hacer pruebas en staging.

Catálogo de herramientas

Todas las herramientas aceptan un business_id (UUID) opcional; omítelo para usar tu primer negocio. Las herramientas de solo lectura se pueden llamar libremente; las marcadas como escritura crean, cambian o envían algo.

Analítica (solo lectura)

Asistentes de IA

Contactos y mensajería de WhatsApp

Biblioteca de medios

Transmisiones

Notas

  • Las fechas son cadenas ISO-8601 (p. ej., 2026-04-15); la zona horaria es un nombre IANA (p. ej., America/Sao_Paulo).
  • search_messages (y su nombre antiguo search_today_messages) tiene un límite de uso por usuario por día.
  • create_whatsapp_template responde en cuanto Meta acepta la plantilla para revisión; la aprobación es asíncrona, así que consulta get_whatsapp_template_status para conocer el resultado. Una plantilla solo aparece en list_whatsapp_templates cuando Meta ya la tiene: esa herramienta lee el catálogo de Meta, no los borradores locales.
  • send_whatsapp_template_message necesita un archivo para una plantilla aprobada con encabezado multimedia (documento, imagen o video), indicado exactamente de una de estas formas:
    • header_media_image_id: una imagen que ya está en la biblioteca de medios, obtenida de upload_library_image o list_library_images. Es la opción preferida para cualquier archivo reutilizado: iZap lo lee directamente del almacenamiento, así que nada expira y no interviene ninguna URL.
    • header_media_document_id: lo mismo para un documento o video, obtenido de upload_library_document o list_library_documents. Su header_kind (document o video) indica con qué formato de encabezado de plantilla encaja.
    • header_media_url: una URL https:// accesible públicamente que iZap descarga.
    • header_media_base64: los bytes en sí, para un archivo puntual. No se guarda en la biblioteca; llama primero a upload_library_image si debe ser reutilizable. El tipo se detecta a partir del contenido, así que JPEG, PNG, PDF, MP4 y 3GPP funcionan, y un documento de texto u Office necesita header_media_url.
    Agrega header_media_filename para controlar el nombre con el que el destinatario ve un documento. El archivo puede ser distinto en cada envío; solo el formato del encabezado lo fija la plantilla aprobada. Los documentos aceptan PDF, texto plano, Word, Excel y PowerPoint de hasta 100 MB; las imágenes aceptan JPEG/PNG de hasta 5 MB y los videos MP4/3GPP de hasta 16 MB. Pasar un encabezado para una plantilla sin encabezado multimedia —u omitirlo para una que sí lo tiene— falla antes de enviar nada.
  • La biblioteca de medios guarda GIF y WebP, que WhatsApp no acepta como imagen de encabezado de plantilla. list_library_images indica usable_as_template_header para cada imagen, así que puedes elegir una válida en lugar de descubrirlo al enviar.
  • Las plantillas con encabezado multimedia deben crearse en el WhatsApp Manager de Meta; create_whatsapp_template todavía no puede enviarlas.
  • Los errores del servidor aparecen como errores de herramienta MCP (isError: true) con el mensaje Error <status>: <detail>; un 401 significa que debes renovar el token.

Usa el MCP en tu código

Obtén un token y luego usa el SDK de MCP para Python o TypeScript para llamar a estas herramientas desde tu propia aplicación o agente.