curl --request POST \
--url https://campaign-orchestration.treble.ai/v2/send-campaign/{poll_id} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"users": [
{
"cellphone": "3051234567",
"country_code": "+57",
"user_session_keys": [
{
"key": "name",
"value": "Juan"
},
{
"key": "TransID",
"value": "12345"
},
{
"key": "schoolname",
"value": "Redschool"
}
]
}
]
}
'{
"message": "The campaign was queued",
"id": "1251072",
"batch_id": "acaab9ea-8754-4d6a-98b1-ace451c7d930",
"launch_request_id": "59d7ef01-4518-444f-816e-1c45c1748974",
"status_url": "/v2/send-campaign/59d7ef01-4518-444f-816e-1c45c1748974"
}{
"detail": "se requiere poll_id, ya sea en la URL o en el cuerpo"
}{
"detail": "API Key inválida"
}{
"detail": "No existe un poll para esta empresa"
}Enviar una campaña (recomendado)
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} (en desuso, deja de funcionar 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.
curl --request POST \
--url https://campaign-orchestration.treble.ai/v2/send-campaign/{poll_id} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"users": [
{
"cellphone": "3051234567",
"country_code": "+57",
"user_session_keys": [
{
"key": "name",
"value": "Juan"
},
{
"key": "TransID",
"value": "12345"
},
{
"key": "schoolname",
"value": "Redschool"
}
]
}
]
}
'{
"message": "The campaign was queued",
"id": "1251072",
"batch_id": "acaab9ea-8754-4d6a-98b1-ace451c7d930",
"launch_request_id": "59d7ef01-4518-444f-816e-1c45c1748974",
"status_url": "/v2/send-campaign/59d7ef01-4518-444f-816e-1c45c1748974"
}{
"detail": "se requiere poll_id, ya sea en la URL o en el cuerpo"
}{
"detail": "API Key inválida"
}{
"detail": "No existe un poll para esta empresa"
}Procesamiento asíncrono
Este endpoint responde202 Accepted en cuanto la campaña se encola, antes de que algún usuario haya sido contactado realmente. Usa el status_url de la respuesta, o llama a Consultar el estado de una campaña, para revisar cómo va.
Seleccionar el número que despliega (empresas multicanal)
Para empresas multicanal, puedes elegir desde qué número de celular se desplegará al usuario usandouser_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.
"user_session_keys": [
{
"key": "deployment_squad",
"value": "DS_[CELLPHONE]"
}
]
Encabezados
API Key de autorización. Se puede obtener en https://app.treble.ai/es/dashboard/settings/developers
Parámetros de ruta
ID del poll que quieres desplegar
Cuerpo
Información de los usuarios a los que se desplegará el poll
Lista de usuarios a los que se desplegará el poll
Show child attributes
Show child attributes
¿Esta página le ayudó?