---
title: "Webhook - Cuando un mensaje es leído"
method: POST
path: "/webhooks/on-read"
tags: ["Webhooks"]
---

# Webhook - Cuando un mensaje es leído

`POST /webhooks/on-read`

Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/webhooks/on-read). Treble llamará a este webhook cuando un mensaje sea leído por el usuario. Debes configurar la URL de este webhook en el panel de administración de Treble.

## Request body

- ReadEvent — Evento que se dispara cuando un mensaje es leído por el usuario
  - `country_code` string, required — Código de país del usuario
  - `cellphone` string, required — Número de teléfono del usuario sin el código de país
  - `session_id` string, required — ID de la sesión del usuario
  - `conversation_id` integer, required — ID de la conversación
  - `question` Question, required
    - `type` string, required — Tipo de pregunta
    - `text` string, required — Texto de la pregunta
  - `sent_at` string, date-time, required — Fecha y hora en que se envió el mensaje
  - `sent_text` string, required — Texto del mensaje enviado
  - `user_session_keys` UserSessionKey[] — Claves de sesión del usuario recopiladas durante la conversación o proporcionadas durante el despliegue
    - `key` string, required — Nombre de la variable. Valores especiales incluyen 'deployment_squad' para seleccionar qué número de teléfono realizará el despliegue en empresas multicanal.
    - `value` string, required — Valor de la variable. Para 'deployment_squad', el valor debe ser 'DS_[CELLPHONE]'.
  - `read_at` string, date-time, required — Fecha y hora en que el mensaje fue leído por el usuario

## Response `200`

Respuesta para actualizar o agregar información a la sesión

- object — Objeto JSON con la nueva información que será reemplazada o agregada a la sesión para uso futuro. El servicio debe responder en menos de 10 segundos.

---

[API](https://skmtc.net/treble/apis/api-de-treble-poll.md) · [All operations](https://skmtc.net/treble/apis/api-de-treble-poll/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treble/api-de-treble-poll/versions/049bfb1c0ab6/schema)