Webhooks

Webhook - Decidir qué agente recibe la conversación

Changed on

Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/webhooks/on-agent-assignation). Treble lo llamará cuando una conversación llegue a un bloque de Métodos de transferencia configurado con el destino API, para que tu sistema decida qué agente debe recibir el chat.

La URL se configura en el propio bloque, dentro del editor de conversaciones. Si activas la autenticación por Token / API Key, Treble incluirá tu token en el header Authorization con el formato Bearer TU_TOKEN.

Debes responder en menos de 10 segundos. Si tu servidor no responde a tiempo, devuelve un código distinto de 200, o devuelve un agente que no puede recibir la conversación, Treble aplicará el método de respaldo configurado en la plataforma principal.

post/webhooks/on-agent-assignation

Request

  • Base URL
    https://tudominio.com
  • URL
    https://tudominio.com/webhooks/on-agent-assignation
  • Auth
    none declared

Headers

Authorizationstring

Solo si configuraste autenticación por Token / API Key en el bloque. Treble envía el token con el formato Bearer TU_TOKEN.

Request body

company_idinteger

Identificador de tu empresa en Treble.

survey_user_idinteger

Identificador de la sesión del contacto en la conversación.

crm_typestring nullable

CRM con el que tu cuenta está integrada, por ejemplo salesforce o hubspot. Es null si la cuenta no tiene integración de CRM.

Example request

{
  "company_id": 1234,
  "survey_user_id": 567890,
  "contact": {
    "treble_id": "5215512345678",
    "name": "Andrea Soto",
    "country_code": "52",
    "cellphone": "5512345678",
    "business_scope_id": "1029384756"
  },
  "crm_type": "salesforce",
  "crm_objects": [
    {
      "entity": "Contact",
      "id": "0035f00000ABCDEqAO"
    }
  ],
  "channel": {
    "phone_number_id": "1234567890"
  },
  "metadata": {
    "poll_id": 4321,
    "node_id": "a1b2c3",
    "tag": "Comercial",
    "language": "es"
  }
}

Response

Agente al que Treble debe asignar la conversación. Devuelve agent_id (recomendado) o agent_email.

agent_idinteger

Identificador del agente en Treble. Es la opción recomendada: es un identificador estable que nunca cambia, incluso si el email del agente se actualiza.

agent_emailstring

Email del agente, exactamente como está registrado en Treble. También es soportado; si envías ambos campos, agent_email tiene precedencia.

Example response

{
  "agent_id": 4567,
  "agent_email": "andrea.soto@tuempresa.com"
}

Changes