---
title: "Enviar una campaña (recomendado)"
method: POST
path: "/v2/send-campaign/{poll_id}"
---

# Enviar una campaña (recomendado)

`POST /v2/send-campaign/{poll_id}`

## Request

- Base URL: `https://campaign-orchestration.treble.ai`
- URL: `https://campaign-orchestration.treble.ai/v2/send-campaign/{poll_id}`
- Auth: none declared. Required headers: `Authorization`

Esta es la forma recomendada de desplegar una conversación a una lista de usuarios, en reemplazo del endpoint anterior `/deployment/api/poll/{poll_id}` (dejará de funcionar pronto, el 15 de noviembre de 2026). El cuerpo de la solicitud no cambia: solo cambia la URL.

La campaña se encola de inmediato y se procesa de forma asíncrona — este endpoint responde `202 Accepted` enseguida, antes de que los usuarios hayan sido contactados realmente. Usa el `status_url` de la respuesta (o llama a `GET /v2/send-campaign/{launch_request_id}`) para revisar el progreso.

## Path parameters

- `poll_id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `users` object[], required: Lista de usuarios a los que se desplegará el poll
    - `cellphone` string, required: Número de teléfono del usuario sin el código de país (por ejemplo: '3051234567')
    - `country_code` string, required: Código de país con el símbolo + (por ejemplo: '+57')
    - `user_session_keys` object[], required: Variables que pueden ser reemplazadas en los textos de las preguntas o entregadas cuando se llama a un webhook. Para empresas multicanal, puede incluir la clave 'deployment_squad' para seleccionar qué número de teléfono realizará el despliegue.
      - `key` string, required: Nombre de la variable. Valores especiales incluyen 'deployment_squad' para seleccionar qué número de teléfono realizará el despliegue.
      - `value` string, required: Valor de la variable. Para 'deployment_squad', el valor debe ser 'DS_[CELLPHONE]'.
    - `deployment_eta` integer: Timestamp UNIX UTC para programar el despliegue para una fecha posterior (opcional). Ejemplo: 1615823201 (15 de marzo de 2021, 3:46:41 PM UTC)

## Response `202`

The campaign was queued for processing

- object
  - `message` string: Confirmation message
  - `id` string: Poll ID
  - `batch_id` string: Idempotency / batch key for this submission
  - `launch_request_id` string: ID to track this submission's progress
  - `status_url` string: Path to poll for this submission's status

## Other responses

- `400`: Error en la solicitud
- `401`: No autorizado. API Key inválida o faltante, o token de sesión inválido/expirado.
- `404`: No existe un poll para esta empresa

## Changes

- **2026-11-03** `aef886191cf5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/treble/apis/api-de-treble-poll/changes/v2/send-campaign/:poll_id/post.md)

---

[API](https://skmtc.dev/treble/apis/api-de-treble-poll.md) - [All operations](https://skmtc.dev/treble/apis/api-de-treble-poll/llms.txt) - [OpenAPI document](https://skmtc.dev/treble/apis/api-de-treble-poll/revisions/aef886191cf5?raw)