Documentación de API Trusted - Llamadas
Base URL
https://tigo-chat-xx-xxx.tigocloud.net🔐 Autenticación
Debes incluir el token de acceso en cada solicitud utilizando el encabezado:
api_access_token: TU_TOKEN_AQUI📤 Crear llamada desde API
POST /trusted/api/v1/inboxes/{inbox_identifier}/calls
Crea una conversación simulando una llamada entrante con datos personalizados del usuario.
🧾 Parámetros en el body:
{
"user": {
"phone_number": "+56971234123",
"name": "Onel Cuellar",
"email": "onelsounid@gmail.com"
},
"custom_attributes": {
"conversation.servicetype": "Personas::fijo",
"account.documentnumber": "95619268",
"contactmedium.phone": "69480041",
"request.type": "Comprar o mejorar mis productos"
},
"subject": "Solicitud de Retención PYME",
"assignee_email": "onel.cuellar@zervizgroup.com",
"labels": [
"sv_llamada_inbound",
"formulario_api"
],
"content": "*ID DE LLAMADA:* 1233434546456\n*LLAMADA INICIADA:* 05/06/02"
}🧪 cURL equivalente
curl -X POST 'https://tigo-chat-xx-xxx.tigocloud.net/trusted/api/v1/inboxes/xxxxxxxxxxxx/calls' \
-H 'Content-Type: application/json' \
-H 'api_access_token: xxxxxxxxxxxxxxx' \
-d '{
"user": {
"phone_number": "+56971234123",
"name": "Onel Cuellar",
"email": "onelsounid@gmail.com"
},
"custom_attributes": {
"conversation.servicetype": "Personas::fijo",
"account.documentnumber": "95619268",
"contactmedium.phone": "69480041",
"request.type": "Comprar o mejorar mis productos"
},
"subject": "Solicitud de Retención PYME",
"assignee_email": "onel.cuellar@zervizgroup.com",
"labels": [
"sv_llamada_inbound",
"formulario_api"
],
"content": "📞 *ID:* 1233434546456\n📱 *CLIENTE:* +56971234123\n🔄 *TIPO:* Entrante\n📝 *MOTIVO:* Compra de servicio\n👨💼 *AGENTE:* Onel Cuéllar\n🕒 *INICIO:* 12/06/2025 14:20\n⏳ *DURACIÓN:* 4m 12s"
}'✅ Respuesta esperada
{
"conversation_id": 529
}✏️ Actualizar llamada existente
PATCH /trusted/api/v1/inboxes/{inbox_identifier}/calls/{conversation_id}
Permite actualizar una conversación existente creada vía llamada. Se pueden modificar atributos personalizados, el agente asignado y añadir una nota interna.
🧾 Parámetros en el body:
{
"custom_attributes": {
"conversation.servicetype": "Personas::fijo"
},
"assignee_email": "alexis.granja@edge.com.py",
"internal_note": "derivado a: Alexis Granja"
}🧪 cURL equivalente
curl -X PATCH 'https://tigo-chat-sv-uat.tigocloud.net/trusted/api/v1/inboxes/Phh3d3FckZcvHe4DfJXwtUhX/calls/529' \
-H 'Content-Type: application/json' \
-H 'api_access_token: xHxiJNHk5a3n4ibBRe7U6R8V' \
-d '{
"custom_attributes": {
"conversation.servicetype": "Personas::fijo"
},
"assignee_email": "alexis.granja@edge.com.py",
"internal_note": "derivado a: Alexis Granja"
}'✅ Respuesta esperada
{
"conversation_id": 529
}