Enviar mensaje

Endpoint · POST /conversation/actions

Envía un mensaje. Cada acción manda un solo tipo de contenido: texto, media, una respuesta rápida o una plantilla. Un texto, media o respuesta rápida puede además llevar una plantilla de fallback para cuando la ventana de 24h esté cerrada (ver abajo).

Texto
Media
Respuesta rápida
Plantilla

{
  "type": "send_message",
  "body": "Hola 👋"
}

Texto plano, hasta 4096 caracteres.

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

El file_uuid viene del flujo de Subir multimedia. El body es un caption opcional; el audio no admite caption.

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

Identifica la respuesta rápida por name (sin distinguir mayúsculas).

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

language es obligatorio (formato Meta lower_UPPER, ej. es_MX). Para plantillas con header de media, ver Subir multimedia.

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

Combinaciones válidas:

Combinación	Campos	Qué se envía
Texto	`body`	El texto (requiere ventana abierta)
Media	`file_uuid` + `body` opcional	La media con caption (requiere ventana abierta)
Respuesta rápida	`quick_reply`	La respuesta rápida (requiere ventana abierta)
Plantilla	`template`	La plantilla (también con la ventana cerrada)
Primario + plantilla	`body` \| `file_uuid` \| `quick_reply` + `template`	El primario si la ventana está abierta; la plantilla si está cerrada

{
  "type": "send_message",
  "body": "Hola 👋",
  "template": {
    "name": "recordatorio",
    "language": "es_MX"
  }
}

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

{
  "type": "send_message",
  "quick_reply": { "name": "Bienvenida" },
  "template": {
    "name": "recordatorio",
    "language": "es_MX"
  }
}

La media de cada lado es independiente: la del primario en file_uuid, la del header de la plantilla en template.header.file_uuid; la de una respuesta rápida va configurada en la respuesta rápida misma. En una lista, este objeto va en el array actions de un POST /conversation/actions — ver Armar una lista de acciones.

Ejemplo ejecutable

Un send_message sobre una conversación identificada por teléfono y canal. Cada acción manda un solo tipo de contenido; un primario (texto, media o quick reply) puede además llevar una plantilla de fallback para cuando la ventana de 24h esté cerrada.

Request

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?"
      }
    ]
  }'

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",
        "file_uuid": "7b8a1c2d-3e4f-5678-90ab-cdef12345678",
        "body": "Tu comprobante 📄"
      }
    ]
  }'

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",
        "quick_reply": { "name": "Bienvenida" }
      }
    ]
  }'

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",
        "template": {
          "name": "confirmacion_cita",
          "language": "es_MX",
          "body_variables": [{ "index": 1, "value": "Ana" }]
        }
      }
    ]
  }'

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"
        }
      }
    ]
  }'

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",
        "quick_reply": { "name": "Bienvenida" },
        "template": {
          "name": "recordatorio",
          "language": "es_MX"
        }
      }
    ]
  }'

Respuesta

202 Accepted — el grupo se aceptó y corre en background. El resultado real por acción no viaja en la respuesta (se consulta después — ver Cómo se ejecuta).

{
  "status": "processing",
  "actions_accepted": 1
}

string

Siempre processing: confirma que el grupo fue aceptado y está en ejecución.

integer

Cuántas acciones del array se admitieron para ejecución — no cuántas tuvieron éxito.

Introducción

Conceptos

Guías

Acciones

Ejemplo ejecutable

Request

Respuesta

​Ejemplo ejecutable

​Request

​Respuesta

Ejemplo ejecutable

Request

Respuesta