En Desarrolladores > Credenciales, crea un token para la integración messages:write. Cópialo al crearlo, guárdalo en tu backend y configura la conexión de WhatsApp en el panel antes de enviar.
Desarrollador de API
API para conectar WhatsApp a tus sistemas y aplicaciones.
Integra CRM, ERP, aplicaciones y sistemas internos con WhatsApp mediante la API REST de WPP Marketing. Envía texto y multimedia, consulta mensajes y realiza el seguimiento de entregas a través de webhooks. Usa también MCP para integrar tus flujos con la API Oficial. Conocer el MCP.
Cuándo usar
Use la API de mensajería cuando su sistema necesite enviar mensajes de WhatsApp.
Use su CRM para iniciar un contacto, su ERP para enviar una actualización o su aplicación para avisar a un cliente. La lógica sobre cuándo enviar queda en su sistema; la API realiza el envío a través de la conexión configurada en la cuenta. Para automatizaciones comerciales listas para usar, utilice la Events API.
Use POST /send-text para texto o POST /send-media para medios. En la conexión oficial, texto e imagen usan las plantillas configuradas; audio, video y documentos requieren un mensaje recibido del cliente en las últimas 24 horas.
HTTP 200 indica aceptación, no entrega. Con messages:read, consulte GET /messages y verifique los estados disponibles para el canal.
Registre la URL HTTPS y habilite los eventos en el panel. Use webhooks:read para consultar los intentos en GET /webhooks; este endpoint lista entregas, no registra suscripciones.
Del token al primer envío incluido.
En su servidor, reemplace SEU_TOKEN por la credencial y el número por el destinatario autorizado para la prueba. Use una clave única por envío y reutilice la misma clave solo al repetir la misma solicitud.
Verifica el estado HTTP y el cuerpo de la respuesta. Para 401, revisa el token y su validez; para 403, comprueba los permisos (scopes) y las condiciones de la cuenta. Para 409, verifica si la clave ya se ha usado con otro contenido. Para 429, respeta Retry-After antes de reintentar.
Luego consulte GET /messages con messages:read o supervise los webhooks configurados. La confirmación de entrega depende de la respuesta del canal.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'Texto, medios, historial y seguimiento de envíos.
Use los endpoints REST para integrar WhatsApp con su aplicación. La API de WPP Marketing utiliza la conexión configurada en la cuenta; para operar con la API Oficial de WhatsApp, configure esa conexión en el panel. Consulte en el OpenAPI los formatos, ámbitos, límites y respuestas de cada operación.
POST
/send-text
Envía un mensaje de texto a un número de WhatsApp.
Texto
POST
/send-media
Envía imagen, audio, vídeo o documento mediante una URL pública HTTPS, según el formato y las condiciones de la conexión. El audio usa este mismo endpoint.
Mídia
GET
/messages
Consulta el historial de mensajes enviados con estado y paginación.
Histórico
GET
/webhooks
Consulta las entregas de webhooks con evento, resultado HTTP, intentos y paginación.
Webhooks
DOC
Swagger / OpenAPI
Documentación interactiva con contratos, ejemplos, campos obligatorios y respuestas esperadas.
Docs
Separación técnica
Elige la función adecuada para cada etapa de la integración.
Envía mensajes con la Messaging API, activa automatizaciones comerciales con la Events API y recibe respuestas mediante webhooks. Tu aplicación puede combinar estas funciones según el flujo necesario.
La conexión oficial es el canal de comunicación; la API de WPP Marketing es la interfaz que utiliza su sistema. Consulte los requisitos en API oficial de WhatsApp y coexistencia.
Su sistema invoca WPP Marketing para enviar mensajes de texto o multimedia y consultar historiales de mensajes y entregas de webhooks.
Su sistema envía eventos comerciales como pedido creado, pago aprobado, envío o carrito abandonado.
Entiende los eventos y las automatizaciones disponiblesWPP Marketing envía eventos estandarizados de creación, entrega, lectura y error a una URL que usted proporcione.
Vea los eventos de devolución y el seguimiento de entregasUse la documentación interactiva para validar payloads, autenticación y respuestas antes de poner en producción.
Los tokens deben permanecer en el backend. No exponga credenciales en páginas públicas, aplicaciones front-end o repositorios.
En /send-text y /send-media, Idempotency-Key permite repetir la misma solicitud con respuesta exitosa durante hasta 48 horas. Reutilizar la clave con otro contenido devuelve 409. Sin la clave, repetir la llamada puede duplicar el envío. Respete los encabezados RateLimit y Retry-After; los límites de solicitudes son distintos de la cuota del plan.
Una credencial por integración, con los permisos necesarios.
En el panel, asigne un nombre al token, seleccione los ámbitos y establezca una expiración opcional. El token completo se muestra solo una vez al crearlo. La lista permite verificar el último uso, la expiración y revocar el acceso cuando sea necesario.
Al cambiar una credencial, actualice el secreto en su servidor y revoque la anterior. Nunca use el token del proveedor de WhatsApp en lugar de la credencial de la API.
Permite enviar texto y medios. Conceda solo a las integraciones que necesiten iniciar envíos.
Permiten consultar, respectivamente, el historial de mensajes y las entregas de los webhooks. Una credencial de envío no recibe estos permisos automáticamente.
Permite informar clientes, carritos y pedidos mediante la Events API a las automatizaciones configuradas en la cuenta.
Consulta configuraciones almacenadas, automatizaciones, recuentos y registros recientes para diagnóstico. Puede incluir datos personales y contenido de mensajes: conceda acceso solo a integraciones y soporte autorizados. Esta consulta no verifica en vivo la conexión con el proveedor.
MCP y API oficial de WhatsApp.
Conecta herramientas de IA a tu operación de WhatsApp con el MCP de WPP Marketing. Integra WhatsApp en los flujos de tus asistentes y agentes, usando la API Oficial como conexión de mensajería.
MCP conecta los flujos de tus agentes a la integración; la API de mensajería realiza los envíos y la conexión oficial sigue las reglas de WhatsApp. Esto no convierte al MCP en un chatbot nativo ni sustituye la configuración de la cuenta. El equipo orienta las acciones y los requisitos de integración para tu caso de uso.
Use MCP como camino de integración entre herramientas de IA y WhatsApp, complementando los flujos de sus sistemas y de su equipo.
Habla con nuestro equipo sobre la herramienta de IA que utilizas y las acciones que deseas conectar a WhatsApp. Revisa los requisitos y el alcance adecuado para tu operación.
Hablar sobre la integración MCP¿Listo para integrar tu sistema con WPP Marketing?
Abra el Swagger para consultar los endpoints de la Messaging API, ejemplos de payload, autenticación con bearer token y respuestas esperadas. Para eventos de la tienda y devoluciones de entrega, vea también Events API y Webhooks de status.