Categorías
Desarrolladores
Establecimiento, Cuentas y Asignación [Desarrolladores]

Establecimiento, Cuentas y Asignación [Desarrolladores]

Consulta información de tu establecimiento, cuentas conectadas y configura reglas de asignación directa.

Actualizado por última vez March 24, 2026

Establecimiento, Cuentas y Asignación

Información del establecimiento

/v2/establishment/ - GET

¿Para qué sirve?

Estos endpoints agrupan funcionalidades de administración general: información de tu cuenta, canales conectados, reglas de asignación de agentes y acceso a archivos multimedia de tickets.

Beneficios concretos

  • Verificar la configuración de tu cuenta y los canales conectados
  • Crear reglas para que ciertos clientes siempre sean atendidos por el mismo agente (asignación directa)
  • Descargar archivos multimedia (fotos, documentos, audios) enviados por clientes en sus tickets
💡
Ejemplo real: Una empresa de seguros quiere que sus clientes VIP siempre sean atendidos por el mismo ejecutivo. Desde su CRM, configuran la regla de asignación directa vía API para que cada cliente VIP tenga asignado su agente fijo.

¿Quién lo usa? Administradores, equipos de operaciones y tecnología que gestionan la configuración de Adereso.

Retorna la información básica de tu establecimiento (empresa) basándose en el token de autenticación proporcionado.

Ejemplo de request

curl -H "Authorization: Key TU_TOKEN" \
  "https://api-cluster.adere.so/v2/establishment/"

Ejemplo de respuesta exitosa:

{
  "status": 200,
  "establishment": {
    "id": 123,
    "name": "Mi Empresa",
    "plan": "enterprise",
    "timezone": "America/Santiago"
  }
}

Cuentas por red social

/v2/accounts/{sn}/ - GET

Obtiene las cuentas conectadas a tu establecimiento, filtradas por red social. Usa 'all' para obtener todas.

Parámetros

Parámetro
Tipo
Requerido
Descripción
sn
string
Sí
Red social: facebook, twitter, whatsapp, app_store, play_store, instagram, chat, email, o 'all' para todas

Ejemplo de request

curl -H "Authorization: Key TU_TOKEN" \
  "https://api-cluster.adere.so/v2/accounts/whatsapp/"

Ejemplo de respuesta exitosa:

{
  "status": 200,
  "accounts": [
    {
      "uid": "56900000000",
      "name": "WhatsApp Ventas",
      "social_network": "whatsapp"
    }
  ]
}

Crear regla de asignación directa

/v2/assignation/direct/ - PUT

Crea una regla de asignación directa para que un usuario específico sea siempre atendido por un agente determinado.

Parámetros

Parámetro
Tipo
Requerido
Descripción
account_uid
string
Sí
UID de la cuenta por donde llega el contacto
user_id
string
Sí
ID del usuario/contacto
primary_email
string
Sí
Email del agente principal asignado
secondary_email
string
Sí
Email del agente secundario (fallback)
supervisor_email
string
Sí
Email del supervisor

Ejemplo de request

curl -X PUT \
  -H "Authorization: Key TU_TOKEN" \
  -H "Content-Type: application/json" \
  "https://api-cluster.adere.so/v2/assignation/direct/" \
  -d '{
    "account_uid": "56900000000",
    "user_id": "5f8a1b2c3d4e5f6789012345",
    "primary_email": "agente1@empresa.com",
    "secondary_email": "agente2@empresa.com",
    "supervisor_email": "supervisor@empresa.com"
  }'

Media de tickets por rango de fechas

/v2/tickets/media/ - GET

Obtiene URLs temporales de archivos multimedia de tickets en un rango de fechas. Las URLs son válidas por 7 días.

💡
Las URLs de archivos multimedia son temporales y expiran a los 7 días.
💡
El rango máximo entre from y to es de 30 días.

Parámetros

Parámetro
Tipo
Requerido
Descripción
from
string
Sí
Fecha inicio (ISO 8601). Ej: 2026-01-01T00:00:00Z
to
string
Sí
Fecha fin (ISO 8601). Rango máximo: 30 días
page
integer
No
Número de página (desde 1)
page_size
integer
No
Resultados por página (máximo 100)
message_direction
string
No
Filtro: inbound, outbound, o all (default)

Ejemplo de request

curl -H "Authorization: Key TU_TOKEN" \
  "https://api-cluster.adere.so/v2/tickets/media/?from=2026-03-01T00:00:00Z&to=2026-03-19T23:59:59Z&message_direction=inbound"

Media de un ticket específico

/v2/ticket/{ticket_id}/media/ - GET

Obtiene URLs temporales de todos los archivos multimedia de un ticket.

Parámetros

Parámetro
Tipo
Requerido
Descripción
ticket_id
string
Sí
ID del ticket
direction
string
No
Filtro: inbound, outbound, o all

Ejemplo de request

curl -H "Authorization: Key TU_TOKEN" \
  "https://api-cluster.adere.so/v2/ticket/583dcb2855d0a46e438d0206/media/?direction=all"
📞
En caso de que tengas dudas, comunícate con nosotros vía chat, al WhatsApp +56953851610 o al email soporte@adere.so.
¿Esto respondió tu pregunta?
😞
😐
🤩
Historial de Asignaciones de Tickets — API v2 Encuestas y Analytics [Desarrolladores]