Send message

Endpoint · POST /conversation/actions

Sends a message. Each action sends one kind of content: text, media, a quick reply, or a template. A text, media, or quick reply can also carry a fallback template for when the 24h window is closed (see below).

Text
Media
Quick reply
Template

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

Plain text, up to 4096 characters.

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

The file_uuid comes from the Upload media flow. The body is an optional caption; audio doesn’t accept a caption.

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

Identifies the quick reply by name (case-insensitive).

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

language is required (Meta format lower_UPPER, e.g. es_MX). For templates with a media header, see Upload media.

Template fallback. A text, media, or quick reply send_message can also include an optional template: if the 24h window is closed at execution time, the template is sent instead of the primary (only templates can be sent outside the window); if it’s open, the primary is sent. Without a template, a primary with the window closed fails with WINDOW_CLOSED.

Valid combinations:

Combination	Fields	What gets sent
Text	`body`	The text (requires an open window)
Media	`file_uuid` + optional `body`	The media with caption (requires an open window)
Quick reply	`quick_reply`	The quick reply (requires an open window)
Template	`template`	The template (also with the window closed)
Primary + template	`body` \| `file_uuid` \| `quick_reply` + `template`	The primary if the window is open; the template if it’s closed

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

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

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

Each side’s media is independent: the primary’s in file_uuid, the template header’s in template.header.file_uuid; a quick reply’s media is configured in the quick reply itself. In a list, this object goes in the actions array of a POST /conversation/actions — see Assembling an action list.

Executable example

A send_message on a conversation identified by phone and channel. Each action sends one content type; a primary (text, media, or quick reply) can also carry a fallback template for when the 24h window is closed.

Request

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "send_message",
        "body": "Hi 👋, how can I help you?"
      }
    ]
  }'

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_your_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": "Your receipt 📄"
      }
    ]
  }'

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_your_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_your_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_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "send_message",
        "body": "Hi 👋",
        "template": {
          "name": "recordatorio",
          "language": "es_MX"
        }
      }
    ]
  }'

curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_your_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"
        }
      }
    ]
  }'

Response

202 Accepted — the group was accepted and runs in the background. The per-action result does not travel in the response (query it later — see How it runs).

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

string

Always processing: confirms the group was accepted and is running.

integer

How many actions in the array were admitted for execution — not how many succeeded.

Introduction

Concepts

Guides

Actions

Executable example

Request

Response

​Executable example

​Request

​Response

Executable example

Request

Response