PUT /v1/agents/{id}/reengagement
How often the agent comes back to a conversation that went cold.
Endpoint
Required scope
agents:write
Body
Example request
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: 0turns 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_templateand a realtemplate_name, an attempt on a cold WhatsApp thread has no way to land.
Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Path Parameters
Body
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.
0 <= x <= 202
Horas desde que la conversacion se enfria hasta el primer intento.
3
Horas entre un intento y el siguiente.
24
Si puede reabrir una conversacion de WhatsApp con una plantilla aprobada.
Nombre de la plantilla aprobada a usar.
"es"
Si un intento puede ser una llamada en vez de un mensaje.
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.
500