Skip to main content
PUT
Configurar el reenganche
Configures whether the agent returns to a conversation that went quiet, how often, and through which medium. The engine only guarantees the heartbeat — when to wake up and how many times. What to do on each attempt — write, call, or let it go — is decided by the agent in that turn, with the conversation in front of it. So the fix for “it insists too much” is fewer attempts, not a longer prompt.

Endpoint

Required scope

agents:write

Body

Example request

curl

Response

200 OK

The whole agent, with its re-engagement in place.

400 Bad Request

max_attempts outside 0–20, or a waiting time outside its range.

404 Not Found

No agent with that id in the token’s company and project.

Operational notes

  • max_attempts: 0 turns it off and keeps the rest of the configuration, so you can switch it back on without retyping the cadence.
  • Two attempts spaced a day apart read as attentive; five read as harassment, and on WhatsApp it costs you the number.
  • Reopening a WhatsApp conversation outside its window needs an approved template. Without allow_template and a real template_name, an attempt on a cold WhatsApp thread has no way to land.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Body

application/json
max_attempts
number
required

Cuantas veces vuelve sobre una conversacion que se enfrio. 0 lo apaga: no hay un enabled aparte porque dos formas de apagar lo mismo terminan contradiciendose.

Required range: 0 <= x <= 20
Example:

2

first_wait_hours
number

Horas desde que la conversacion se enfria hasta el primer intento.

Example:

3

between_hours
number

Horas entre un intento y el siguiente.

Example:

24

allow_template
boolean

Si puede reabrir una conversacion de WhatsApp con una plantilla aprobada.

template_name
string

Nombre de la plantilla aprobada a usar.

template_language
string
Example:

"es"

allow_call
boolean

Si un intento puede ser una llamada en vez de un mensaje.

conduct
string

Instruccion del negocio para el turno de reactivacion, si quiere acotarlo. Que hacer en cada intento lo decide el agente con la conversacion a la vista; esto lo encuadra.

Maximum string length: 500

Response

200 - application/json
agent
object
required