{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.- Cursor
- Claude
- ChatGPT
- Codex CLI
- Manus
- Grok
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 unbusiness_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 antiguosearch_today_messages) tiene un límite de uso por usuario por día. -
create_whatsapp_templateresponde en cuanto Meta acepta la plantilla para revisión; la aprobación es asíncrona, así que consultaget_whatsapp_template_statuspara conocer el resultado. Una plantilla solo aparece enlist_whatsapp_templatescuando Meta ya la tiene: esa herramienta lee el catálogo de Meta, no los borradores locales. -
send_whatsapp_template_messagenecesita 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 deupload_library_imageolist_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 deupload_library_documentolist_library_documents. Suheader_kind(documentovideo) indica con qué formato de encabezado de plantilla encaja.header_media_url: una URLhttps://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 aupload_library_imagesi 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 necesitaheader_media_url.
header_media_filenamepara 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_imagesindicausable_as_template_headerpara 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_templatetodavía no puede enviarlas. -
Los errores del servidor aparecen como errores de herramienta MCP
(
isError: true) con el mensajeError <status>: <detail>; un401significa 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.