> ## Documentation Index > Fetch the complete documentation index at: https://help.treble.ai/llms.txt > Use this file to discover all available pages before exploring further. # Desplegar un flujo de conversación > 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. Recuerda que para usar este endpoint, debes haber obtenido tu llave de API en la sección de **Desarrolladores** de la plataforma Treble. ## Seleccionar el número que despliega (empresas multicanal) Para empresas multicanal, puedes elegir desde qué número de celular se desplegará al usuario usando `user_session_keys`. Si quieres que el primer número realice el despliegue, basta con agregar la clave `deployment_squad` y su valor correspondiente será `DS_[CELLPHONE]`. Puedes agregar varios *deployment squads* para que distintos números puedan desplegar. ```json theme={null} "user_session_keys": [ { "key": "deployment_squad", "value": "DS_[CELLPHONE]" } ] ``` ## OpenAPI ````yaml open-api-files/treble-api-es.json POST /deployment/api/poll/{poll_id} openapi: 3.0.1 info: title: API de Treble Poll description: Documentación para el endpoint de despliegue de polls en Treble version: 1.0.0 servers: - url: https://main.treble.ai description: Servidor principal de Treble - url: https://tudominio.com description: >- Servidor de ejemplo para implementar los webhooks. Esto representa TU servidor donde debes implementar los endpoints que Treble llamará. security: [] tags: - name: Webhooks description: >- Endpoints que Treble llamará en tu servidor. Estos no son endpoints reales que puedas llamar, sino una representación de los webhooks que Treble invocará en tu sistema. paths: /deployment/api/poll/{poll_id}: post: summary: Desplegar un poll a usuarios específicos description: >- 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. parameters: - name: poll_id in: path required: true description: ID del poll que se desea desplegar schema: type: string - name: Authorization in: header required: true description: >- API Key de autorización. Se puede obtener en https://app.treble.ai/es/dashboard/settings/developers schema: type: string example: API_KEY - name: Content-Type in: header required: true schema: type: string enum: - application/json requestBody: description: Información de los usuarios a los que se desplegará el poll required: true content: application/json: schema: type: object required: - users properties: users: type: array description: Lista de usuarios a los que se desplegará el poll items: type: object required: - cellphone - country_code - user_session_keys properties: cellphone: type: string description: >- Número de teléfono del usuario sin el código de país (por ejemplo: '3051234567') country_code: type: string description: 'Código de país con el símbolo + (por ejemplo: ''+57'')' user_session_keys: type: array description: >- 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. items: type: object required: - key - value properties: key: type: string description: >- Nombre de la variable. Valores especiales incluyen 'deployment_squad' para seleccionar qué número de teléfono realizará el despliegue. value: type: string description: >- Valor de la variable. Para 'deployment_squad', el valor debe ser 'DS_[CELLPHONE]'. deployment_eta: type: integer description: >- Timestamp UNIX UTC para programar el despliegue para una fecha posterior (opcional). Ejemplo: 1615823201 (15 de marzo de 2021, 3:46:41 PM UTC) examples: Ejemplo básico: value: users: - cellphone: '3051234567' country_code: '+57' user_session_keys: - key: name value: Juan - key: TransID value: '12345' - key: schoolname value: Redschool Ejemplo con deployment_eta: value: users: - cellphone: '3051234567' country_code: '+57' user_session_keys: - key: name value: Juan deployment_eta: 1615823201 Ejemplo con deployment_squad: value: users: - cellphone: '3051234567' country_code: '+57' user_session_keys: - key: name value: Juan - key: deployment_squad value: DS_[CELLPHONE] responses: '200': description: El poll fue desplegado correctamente content: application/json: schema: type: object properties: message: type: string description: Mensaje de confirmación id: type: string description: ID del despliegue batch_id: type: string description: ID del lote de despliegue new_last_scheduleded_deployment: type: string format: date-time description: Fecha y hora del último despliegue programado conversations_id: type: array items: type: string description: Lista de IDs de las conversaciones creadas example: message: The poll was deployed id: 5f8d7e6a5f8d7e6a5f8d7e6a batch_id: 5f8d7e6a5f8d7e6a5f8d7e6b new_last_scheduleded_deployment: '2021-03-15T15:46:41Z' conversations_id: - 5f8d7e6a5f8d7e6a5f8d7e6c '400': description: Error en la solicitud content: application/json: schema: type: object properties: error: type: string description: Código de error message: type: string description: Descripción del error '401': description: No autorizado. API Key inválida o faltante. content: application/json: schema: type: object properties: error: type: string description: Código de error message: type: string description: Descripción del error '404': description: Poll no encontrado content: application/json: schema: type: object properties: error: type: string description: Código de error message: type: string description: Descripción del error ````