Skip to main content
POST
Conversar con un agente

Autorizaciones

Authorization
string
header
requerido

Tu clave de API (bk_live_... o bk_test_...).

Encabezados

Idempotency-Key
string

Identificador único de esta llamada. Un reintento con el mismo valor no vuelve a cobrar.

Maximum string length: 200

Parámetros de ruta

negocioId
string
requerido

Identificador del negocio dentro de tu organización.

Cuerpo

application/json
mensajes
object[]
requerido

Historial de la conversación, del más antiguo al más reciente.

Minimum array length: 1
sesion
string

Identificador estable de la conversación (por ejemplo, el teléfono del cliente). Si lo repites, recordamos el hilo y los datos del cliente entre llamadas y entre días. Si lo omites, cada llamada empieza de cero.

Ejemplo:

"cliente-34600111222"

Respuesta

Respuesta del agente

respuesta
string

El texto que enviar al cliente.

calendario_url
string | null

Enlace .ics para añadir la cita, si se ha cerrado una reserva.

negocio_id
string