Detalles del Endpoint
Método HTTP: POST URL: [https://voice-gateway-service-production.up.railway.app/api/v1/calls](https://voice-gateway-service-production.up.railway.app/api/v1/calls)
Encabezados (Headers)
Encabezado | Valor | Descripción |
Content-Type |
| Especifica el formato del payload. |
X-API-KEY |
| La clave de API (API Key) asociada a tu Unidad Organizativa (OU). |
Parámetros del Payload de la Solicitud
Debes enviar los siguientes parámetros en el cuerpo (body) JSON de tu solicitud:
Parámetro | Tipo | Descripción |
| Entero | El identificador único del canal de la llamada. Se puede encontrar en Retool. |
| Cadena | El número de teléfono del canal que origina la llamada. |
| Cadena | El número de teléfono de destino del cliente. |
| Cadena | El nombre del cliente que recibe la llamada. |
| Cadena | Opcional. Sobrescribe el pipeline predeterminado. Añade el ID del pipeline específico que deseas utilizar. |
| Objeto | Opcional. Vincula las etiquetas |
| Cadena | Opcional. Sobrescribe el primer mensaje (mensaje de apertura) configurado por defecto en el pipeline. |
| Objeto | Opcional. Vincula las etiquetas |
Ejemplos de Código
Ejemplo 1: Llamada Saliente Estándar con Variables de Prompt Personalizadas
Este ejemplo demuestra cómo iniciar una llamada inyectando variables dinámicas tanto en el prompt de la misión como en un primer mensaje personalizado.
Bash
curl --location 'https://voice-gateway-service-production.up.railway.app/api/v1/calls' \ --header 'Content-Type: application/json' \ --header 'X-API-KEY: <YOUR_API_KEY>' \ --data '{ "channel_id": 123, "from_phone_number": "+549341567894", "to_phone_number": "+5493415678937", "customer_name": "John Doe", "initial_pipeline_id": "345", "prompt_templates": { "consignatario": "onboarding" }, "first_message": "Hello, how are you?", "variable_values": { "name": "John Doe" } }'