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": "João"
},
{
"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": "poll_id é obrigatório, na URL ou no corpo"
}{
"detail": "Chave de API inválida"
}{
"detail": "Não existe um poll para esta empresa"
}Enviar uma campanha (recomendado)
Esta é a forma recomendada de implantar uma conversa para uma lista de usuários, substituindo o endpoint antigo /deployment/api/poll/{poll_id} (descontinuado, deixa de funcionar em 15 de novembro de 2026). O corpo da requisição não muda: só a URL é diferente.
A campanha é enfileirada imediatamente e processada de forma assíncrona — este endpoint responde 202 Accepted na hora, antes dos usuários terem sido realmente contatados. Use o status_url da resposta (ou chame GET /v2/send-campaign/{launch_request_id}) para acompanhar o progresso.
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": "João"
},
{
"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": "poll_id é obrigatório, na URL ou no corpo"
}{
"detail": "Chave de API inválida"
}{
"detail": "Não existe um poll para esta empresa"
}Processamento assíncrono
Este endpoint responde202 Accepted assim que a campanha é enfileirada, antes de qualquer usuário ter sido realmente contatado. Use o status_url da resposta, ou chame Consultar o status de uma campanha, para acompanhar o progresso.
Selecionar qual número implanta (empresas multicanal)
Para empresas multicanal, você pode selecionar de qual celular o usuário será implantado usandouser_session_keys. Se você quiser que o primeiro número faça a implantação, basta adicionar a chave deployment_squad e o valor correspondente será DS_[CELLPHONE]. Você pode adicionar vários deployment squads para que vários números possam implantar.
"user_session_keys": [
{
"key": "deployment_squad",
"value": "DS_[CELLPHONE]"
}
]
Cabeçalhos
Chave API de autorização. Pode ser obtida em https://app.treble.ai/en/dashboard/settings
Parâmetros de caminho
ID do poll que você quer implantar
Corpo
Informações dos usuários para os quais o poll será implantado
Lista de usuários para os quais o poll será implantado
Show child attributes
Show child attributes
Esta página foi útil?