API REST · mensajes

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Tu pedido está preparado para recoger en la tienda."
}

Mensaje creado · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

API de WhatsApp para tu sistema

Tu sistema avisa.Tu equipo sigue el hilo.

Cuando un pedido está preparado, tu sistema puede crear el mensaje. Tu equipo continúa la conversación en Pulpo.

Empezar gratis Verlo en acción

Datos ficticios. Usa una cuenta autorizada, un número operativo y las condiciones de envío que correspondan.

Petición, evento y plantilla.

Ejemplos de operaciones documentadas. Consulta el esquema completo y prueba con tu cuenta antes de integrar.

El pedido ya está preparado

Crear un mensaje

Avisar de que el pedido se puede recoger.

Tu servidor usa la cabecera Token y el cuerpo de la petición. El destinatario y el texto de este ejemplo son ficticios.

PulpoChatAPI REST · mensajes

Petición de ejemplo

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Tu pedido está preparado para recoger en la tienda."
}

Mensaje creado · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

El 201 confirma la creación del mensaje. Consulta su evolución antes de dar por hecho que llegó al destinatario.

Comprueba acceso al número, permiso del destinatario y las reglas de envío. Si tienes varios números, revisa el campo device en la documentación.

Llega una nueva conversación

Recibir un evento

Informar a tu sistema de un mensaje entrante.

Configuras tu URL de webhook y los eventos que necesitas. Este fragmento muestra campos de un evento; no es su esquema completo.

PulpoChatWebhook · mensaje entrante

POST a tu servidor · ejemplo

POST https://tu-servidor.example/webhooks/pulpo
Content-Type: application/json
X-Idempotency-Key: ID_EVENTO_DE_EJEMPLO

{
  "id": "ID_MENSAJE_DE_EJEMPLO",
  "object": "message",
  "event": "message:in:new"
}

Respuesta de tu servidor · ejemplo

HTTP/1.1 200 OK

Tu servidor procesa el evento y decide qué hacer con él. Prepara el manejo de reintentos para evitar procesar el mismo evento varias veces.

Usa HTTPS en producción y valida el esquema completo. Recibir un webhook no envía una respuesta de WhatsApp por sí solo.

Preparas un aviso proactivo

Consultar plantillas

Encontrar una plantilla aprobada para el aviso.

Consulta las plantillas de la cuenta y revisa nombre, idioma y contenido antes de preparar el envío.

PulpoChatAPI REST · plantillas

Consulta de ejemplo

GET https://api.pulpo.chat/v1/waba/templates?status=approved
Token: TU_CLAVE_DE_API

Fragmento de respuesta · ejemplo

{"data":[{"name":"PLANTILLA_DE_EJEMPLO",
"status":"approved","language":"es"}],
"total":1,"page":0,"size":1}

La consulta devuelve las plantillas que puedes revisar. Para enviar, sigue el formato y los requisitos de la documentación.

Las plantillas aprobadas son necesarias cuando las reglas de WhatsApp lo exigen. Esta consulta no crea ni envía un mensaje.

De ejemplo a integración.

Prueba la petición, prepara el receptor del evento o consulta el esquema de plantillas.

Crear el mensaje desde tu sistema

Revisa el esquema de mensajes y prueba la petición con una cuenta preparada en el probador de la API.

Abrir el probador de la API

Recibir lo que ocurre en WhatsApp

Prepara tu receptor HTTPS, selecciona los eventos y maneja los reintentos antes de usarlo en producción.

Consultar la guía de webhooks

Revisar las plantillas de la cuenta

Consulta las plantillas aprobadas y los formatos de envío con su idioma y variables.

Abrir la documentación de la API

¿Prefieres preparar un recorrido visual?

Flows reúne pasos y conexiones que tienes que configurar y probar. El servidor MCP permite pedir tareas desde un cliente autorizado como ChatGPT o Claude.

Ver Flows Ver el servidor MCP

Una clave. Un número. Una prueba.

Mantén las credenciales en tu servidor y comprueba la operación antes de conectarla al trabajo real.

Crea y protege tu clave
Usa una clave autorizada para tu cuenta. Guárdala en el servidor y revisa su acceso antes de compartir una integración.
Comprueba el número
Verifica que el número está operativo y que tu cuenta tiene acceso y capacidad para la operación.
Prueba petición y eventos
Consulta el esquema, haz una petición de prueba y valida la respuesta. Si usas webhooks, prepara el receptor y sus reintentos.

Antes de empezar

Una cuenta autorizada y un número operativo.
Credenciales protegidas en tu servidor; los ejemplos no incluyen una clave real.
Permiso del destinatario y plantillas aprobadas cuando el envío lo requiera.
Un receptor HTTPS y manejo de reintentos si usas webhooks.

Empezar gratis Ver planes y condiciones

Antes de conectar tu sistema.

¿Un 201 significa que el mensaje llegó?

El 201 confirma que se ha creado el mensaje. Consulta su estado y los eventos disponibles para seguir su evolución; no lo uses como prueba de entrega o lectura.

¿Puedo poner mi clave en la página web?

Mantén la clave en tu servidor. Evita exponerla en el navegador, repositorios públicos o ejemplos compartidos.

¿Cuándo necesito una plantilla aprobada?

Cuando las reglas de WhatsApp la exijan, como en los mensajes proactivos fuera de la ventana de atención. Revisa los requisitos y el formato de envío en la documentación.

Prepara el aviso que necesita tu sistema.

Empezar gratis

Crea tu cuenta, comprueba el acceso y consulta la documentación para probar la operación.