Conversations
Actualizar estado masivo
Actualizar el estado de múltiples conversaciones a la vez.
POST
/
api
/
conversations
/
update-status
# Marcar todas las conversaciones como resueltas
curl -X POST "https://app.horneross.com/api/conversations/update-status" \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"status": "RESOLVED"
}'
# Marcar solo conversaciones de WhatsApp como resueltas
curl -X POST "https://app.horneross.com/api/conversations/update-status?channel=whatsapp" \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"status": "RESOLVED"
}'
async function bulkUpdateStatus(status, options = {}) {
const params = new URLSearchParams(options);
const url = params.toString()
? `https://app.horneross.com/api/conversations/update-status?${params}`
: 'https://app.horneross.com/api/conversations/update-status';
const response = await fetch(url, {
method: 'POST',
headers: {
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({ status }),
});
return response.json();
}
// Marcar todas como resueltas
const result = await bulkUpdateStatus('RESOLVED');
console.log(`Updated ${result.count} conversations`);
// Solo de un agente específico
await bulkUpdateStatus('RESOLVED', { agentId: 'ag_xyz789' });
import requests
def bulk_update_status(status, channel=None, agent_id=None):
params = {}
if channel:
params['channel'] = channel
if agent_id:
params['agentId'] = agent_id
response = requests.post(
'https://app.horneross.com/api/conversations/update-status',
headers={
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json'
},
params=params,
json={'status': status}
)
return response.json()
# Marcar todas como resueltas
result = bulk_update_status('RESOLVED')
print(f"Updated {result['count']} conversations")
# Solo de WhatsApp
result = bulk_update_status('RESOLVED', channel='whatsapp')
{
"count": 42
}
Endpoint
POST /api/conversations/update-status
Headers
Bearer token con tu API key de organización.
Siempre
application/jsonQuery Parameters
Filtrar por canal. Solo actualiza conversaciones de este canal.
Filtrar por agente. Solo actualiza conversaciones de este agente.
Request Body
Nuevo estado para las conversaciones. Valores:
UNRESOLVED, RESOLVED, HUMAN_REQUESTED# Marcar todas las conversaciones como resueltas
curl -X POST "https://app.horneross.com/api/conversations/update-status" \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"status": "RESOLVED"
}'
# Marcar solo conversaciones de WhatsApp como resueltas
curl -X POST "https://app.horneross.com/api/conversations/update-status?channel=whatsapp" \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"status": "RESOLVED"
}'
async function bulkUpdateStatus(status, options = {}) {
const params = new URLSearchParams(options);
const url = params.toString()
? `https://app.horneross.com/api/conversations/update-status?${params}`
: 'https://app.horneross.com/api/conversations/update-status';
const response = await fetch(url, {
method: 'POST',
headers: {
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({ status }),
});
return response.json();
}
// Marcar todas como resueltas
const result = await bulkUpdateStatus('RESOLVED');
console.log(`Updated ${result.count} conversations`);
// Solo de un agente específico
await bulkUpdateStatus('RESOLVED', { agentId: 'ag_xyz789' });
import requests
def bulk_update_status(status, channel=None, agent_id=None):
params = {}
if channel:
params['channel'] = channel
if agent_id:
params['agentId'] = agent_id
response = requests.post(
'https://app.horneross.com/api/conversations/update-status',
headers={
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json'
},
params=params,
json={'status': status}
)
return response.json()
# Marcar todas como resueltas
result = bulk_update_status('RESOLVED')
print(f"Updated {result['count']} conversations")
# Solo de WhatsApp
result = bulk_update_status('RESOLVED', channel='whatsapp')
Response
Número de conversaciones actualizadas
{
"count": 42
}
Estados disponibles
| Estado | Descripción |
|---|---|
UNRESOLVED | Conversación activa, esperando respuesta |
RESOLVED | Marcada como resuelta |
HUMAN_REQUESTED | El usuario solicitó hablar con un humano |
Was this page helpful?
⌘I
# Marcar todas las conversaciones como resueltas
curl -X POST "https://app.horneross.com/api/conversations/update-status" \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"status": "RESOLVED"
}'
# Marcar solo conversaciones de WhatsApp como resueltas
curl -X POST "https://app.horneross.com/api/conversations/update-status?channel=whatsapp" \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"status": "RESOLVED"
}'
async function bulkUpdateStatus(status, options = {}) {
const params = new URLSearchParams(options);
const url = params.toString()
? `https://app.horneross.com/api/conversations/update-status?${params}`
: 'https://app.horneross.com/api/conversations/update-status';
const response = await fetch(url, {
method: 'POST',
headers: {
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({ status }),
});
return response.json();
}
// Marcar todas como resueltas
const result = await bulkUpdateStatus('RESOLVED');
console.log(`Updated ${result.count} conversations`);
// Solo de un agente específico
await bulkUpdateStatus('RESOLVED', { agentId: 'ag_xyz789' });
import requests
def bulk_update_status(status, channel=None, agent_id=None):
params = {}
if channel:
params['channel'] = channel
if agent_id:
params['agentId'] = agent_id
response = requests.post(
'https://app.horneross.com/api/conversations/update-status',
headers={
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json'
},
params=params,
json={'status': status}
)
return response.json()
# Marcar todas como resueltas
result = bulk_update_status('RESOLVED')
print(f"Updated {result['count']} conversations")
# Solo de WhatsApp
result = bulk_update_status('RESOLVED', channel='whatsapp')
{
"count": 42
}
