Reglas de Asistencia

Configuran cuándo el agente debe escalar la conversación a un humano y qué mensaje mostrar mientras tanto.

Consejo

Estos mismos campos también se pueden setear desde PATCH /v1/agents/{agentId} . Este endpoint dedicado existe para simetría con la UI del builder y para poder enviarlos sin tocar el resto del agente.

Obtener Reglas de Asistencia

GET https://api.platica.mx/v1/agents/{agentId}/assist-rules

Parámetros de URL

Parámetro	Tipo	Descripción	Requerido
`agentId`	string	Identificador único del agente	✓

Respuesta

{
  "assistanceTriggers": "Cuando el cliente pide hablar con una persona, se queja repetidamente, o pide algo que no puedo resolver",
  "assistanceEnabled": true,
  "waitMessage": "Un momento, te conecto con un agente humano."
}

Campos de la respuesta

Campo	Descripción
`assistanceTriggers`	Texto en lenguaje natural describiendo cuándo escalar
`assistanceEnabled`	Si la escalada a humano está habilitada para este agente
`waitMessage`	Mensaje que se envía al cliente mientras espera al humano

Actualizar Reglas de Asistencia

Todos los campos son opcionales; al menos uno debe estar presente.

PATCH https://api.platica.mx/v1/agents/{agentId}/assist-rules

Parámetros de URL

Parámetro	Tipo	Descripción	Requerido
`agentId`	string	Identificador único del agente	✓

Cuerpo de la solicitud

{
  "assistanceEnabled": true,
  "assistanceTriggers": "Cuando el cliente pide hablar con una persona o se queja repetidamente",
  "waitMessage": "Un momento, te conecto con un agente humano."
}

Parámetro	Tipo	Descripción	Validación
`assistanceEnabled`	boolean	Si la escalada a humano está habilitada	—
`assistanceTriggers`	string	Cuándo escalar (lenguaje natural)	Máximo 650 caracteres
`waitMessage`	string	Mensaje mostrado al cliente mientras espera	Máximo 500 caracteres

Respuesta

{
  "status": "success",
  "message": "Agent assist-rules updated successfully",
  "data": {
    "assistanceTriggers": "Cuando el cliente pide hablar con una persona o se queja repetidamente",
    "assistanceEnabled": true,
    "waitMessage": "Un momento, te conecto con un agente humano."
  }
}

data siempre refleja el estado completo de las reglas tras el merge, no sólo los campos actualizados.

Anterior Guardrails del Agente Siguiente Horario de Atención