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
string
required
Bearer token con tu API key de organización.
string
required
Siempre
application/jsonQuery Parameters
string
Filtrar por canal. Solo actualiza conversaciones de este canal.
string
Filtrar por agente. Solo actualiza conversaciones de este agente.
Request Body
string
required
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
number
required
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
}
