---
title: "Desplegar un poll a usuarios específicos"
method: POST
path: "/deployment/api/poll/{poll_id}"
---

# Desplegar un poll a usuarios específicos

`POST /deployment/api/poll/{poll_id}`

Este endpoint permite desplegar un conversación a una lista de usuarios definidos por su número de teléfono y código de país. También permite programar despliegues para una fecha posterior.

## Path parameters

- `poll_id` string, required

## Headers

- `Authorization` string, required
- `Content-Type` 'application/json', 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 `200`

El poll fue desplegado correctamente

- object
  - `message` string — Mensaje de confirmación
  - `id` string — ID del despliegue
  - `batch_id` string — ID del lote de despliegue
  - `new_last_scheduleded_deployment` string, date-time — Fecha y hora del último despliegue programado
  - `conversations_id` string[] — Lista de IDs de las conversaciones creadas

## Other responses

- `400` — Error en la solicitud
- `401` — No autorizado. API Key inválida o faltante.
- `404` — Poll no encontrado

---

[API](https://skmtc.net/treble/apis/api-de-treble-poll.md) · [All operations](https://skmtc.net/treble/apis/api-de-treble-poll/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treble/api-de-treble-poll/versions/049bfb1c0ab6/schema)