Mensajes

Todos los envíos de WhatsApp salen por una sola acción, send_message, dentro del endpoint POST /conversation/actions. Una misma acción cubre los cuatro modos —texto, media, respuesta rápida y plantilla—; cuál puedes usar depende del estado de la ventana de 24h de la conversación.

Qué modo aplica según la ventana

Modo	Ventana abierta	Ventana cerrada
Texto	✅	❌ `WINDOW_CLOSED`
Media	✅	❌ `WINDOW_CLOSED`
Respuesta rápida	✅	❌ `WINDOW_CLOSED`
Plantilla	✅	✅ — reabre la ventana

La plantilla es el único mensaje enviable con la ventana cerrada. Además, enviarla reabre la ventana, habilitando texto, media y respuesta rápida otra vez.

Los cuatro modos de `send_message`

Cada send_message manda un solo tipo de contenido: texto (body), media (file_uuid), una respuesta rápida (quick_reply) o una plantilla (template). Los tres primeros admiten además una plantilla de fallback para cuando la ventana está cerrada (ver abajo).

Texto
Media
Respuesta rápida
Plantilla

Texto plano, hasta 4096 caracteres.

{
  "type": "send_message",
  "body": "Hola 👋, ¿en qué te puedo ayudar?"
}

Imagen, video, audio o documento: pasa un file_uuid de un archivo ya subido y confirmado, con body como caption opcional. El tipo se deduce del archivo; el audio no admite caption. El flujo de subida está en Subir multimedia.

{
  "type": "send_message",
  "file_uuid": "7b8a1c2d-3e4f-5678-90ab-cdef12345678",
  "body": "Tu comprobante 📄"
}

Una respuesta rápida preconfigurada en el dashboard, identificada por name (sin distinguir mayúsculas). Puede emitir varios mensajes.

{
  "type": "send_message",
  "quick_reply": { "name": "Bienvenida" }
}

Una plantilla aprobada por Meta — el único modo que funciona con la ventana cerrada. language es obligatorio (formato Meta lower_UPPER, ej. es_MX). Ver Plantillas.

{
  "type": "send_message",
  "template": {
    "name": "confirmacion_cita",
    "language": "es_MX",
    "body_variables": [{ "index": 1, "value": "Ana" }]
  }
}

Enviar

El envío es una acción dentro del grupo. Manda un POST /conversation/actions con un send_message en el array actions:

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "send_message",
        "body": "Hola 👋, ¿en qué te puedo ayudar?"
      }
    ]
  }'

Responde 202: el envío corre en background. Consulta el resultado en el estado de la conversación o en el activity log. Para encadenar varios envíos u otras acciones en un mismo request, ver Acciones.

Fallback de plantilla para la ventana cerrada

Un send_message de texto, media o respuesta rápida puede incluir además un template opcional: si al ejecutarse la ventana está cerrada, se envía la plantilla en vez del primario; si está abierta, se envía el primario. Sin template, un primario con la ventana cerrada falla con WINDOW_CLOSED.

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "send_message",
        "body": "Hola 👋",
        "template": {
          "name": "recordatorio",
          "language": "es_MX"
        }
      }
    ]
  }'

Introducción

Conceptos

Guías

Acciones

Qué modo aplica según la ventana

Los cuatro modos de `send_message`

Enviar

Fallback de plantilla para la ventana cerrada

Próximos pasos

Plantillas

Acciones

​Qué modo aplica según la ventana

​Los cuatro modos de send_message

​Enviar

​Fallback de plantilla para la ventana cerrada

​Próximos pasos

Plantillas

Acciones

Qué modo aplica según la ventana

Los cuatro modos de `send_message`

Enviar

Fallback de plantilla para la ventana cerrada

Próximos pasos