---
title: "Webhook - Decidir qué agente recibe la conversación"
method: POST
path: "/webhooks/on-agent-assignation"
tags: ["Webhooks"]
---

# Webhook - Decidir qué agente recibe la conversación

`POST /webhooks/on-agent-assignation`

## Request

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

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.

## Headers

- `Authorization` string

## Request body

- AgentAssignationRequest: Cuerpo que Treble envía a tu endpoint para que decidas qué agente recibe la conversación.
  - `company_id` integer: Identificador de tu empresa en Treble.
  - `survey_user_id` integer: Identificador de la sesión del contacto en la conversación.
  - `contact` AgentAssignationContact: Información del contacto que está en la conversación.
    - `treble_id` string: Identificador del contacto en Treble.
    - `name` string, nullable: Nombre del contacto.
    - `country_code` string, nullable: Indicativo del país. Puede ser `null` en contactos que solo existen como usuario de Meta.
    - `cellphone` string, nullable: Número de celular sin indicativo. Puede ser `null` en contactos que solo existen como usuario de Meta.
    - `business_scope_id` string, nullable: Identificador del contacto dentro del alcance de tu negocio en Meta.
    - `username` string, nullable: Usuario de Meta del contacto, cuando aplica.
  - `crm_type` string, 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.
  - `crm_objects` AgentAssignationCrmObject[]: Registros del CRM asociados al contacto. Un arreglo vacío significa que el contacto aún no está asociado a ningún registro.
    - `entity` string: Tipo de objeto en el CRM, por ejemplo `Contact`, `Account` o `Lead`.
    - `id` string: Identificador del registro en tu CRM.
  - `channel` AgentAssignationChannel: Canal por el que entró la conversación.
    - `phone_number_id` string: Identificador de la línea de WhatsApp que recibió la conversación.
  - `metadata` AgentAssignationMetadata: Contexto del flujo y del bloque que originó la llamada.
    - `poll_id` integer: Identificador de la conversación (flujo) de Treble.
    - `node_id` string: Identificador del bloque de Métodos de transferencia que originó la llamada.
    - `tag` string, nullable: Equipo (tag) seleccionado en el bloque.
    - `language` string, nullable: Idioma de la conversación.

## Response `200`

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

- AgentAssignationResponse: Respuesta que tu servidor debe devolver indicando el agente que recibirá la conversación. Usa `agent_id` o `agent_email`.
  - `agent_id` integer: 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_email` string: Email del agente, exactamente como está registrado en Treble. También es soportado; si envías ambos campos, `agent_email` tiene precedencia.

## Changes

- **2026-11-03** `aef886191cf5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/treble/apis/api-de-treble-poll/changes/webhooks/on-agent-assignation/post.md)

---

[API](https://skmtc.dev/treble/apis/api-de-treble-poll.md) - [All operations](https://skmtc.dev/treble/apis/api-de-treble-poll/llms.txt) - [OpenAPI document](https://skmtc.dev/treble/apis/api-de-treble-poll/revisions/aef886191cf5?raw)