knowledge_file.ready
Un archivo de conocimiento terminó de subirse y Ricky lo leyó. Un archivo que Ricky no pudo leer también queda listo, con extraction_error.
Ricky firma cada entrega: X-Ricky-Signature: v1=<hex> es el HMAC-SHA256 de <X-Ricky-Timestamp>.<raw body> con el signing_secret del webhook como clave. Después de rotar el secreto, la cabecera lleva dos firmas separadas por coma, primero la nueva, hasta que vence el secreto anterior: acepta el evento si coincide cualquier valor v1=. Ricky lo envía segundos después del evento. Responde cualquier 2xx en menos de 10 segundos; Ricky hace hasta diez intentos con esperas cada vez más largas y puede entregar un evento dos veces, así que descarta duplicados por id.
X-Ricky-Delivery-Id*stringID de la entrega; igual al id del cuerpo.
X-Ricky-Timestamp*stringHora Unix del intento.
X-Ricky-Signature*stringv1= y el HMAC-SHA256 en hexadecimal; dos valores separados por coma durante una rotación del secreto.
application/json- body
El cuerpo JSON que Ricky envía al endpoint de un webhook.
id*stringID de la entrega. Descarta duplicados con él.
uuidtype*string"message.received""message.sent""message.delivered""message.read""message.failed""conversation.opened""conversation.closed""conversation.assignment_changed""conversation.agent_changed""conversation.handoff_requested""conversation.handoff_resolved""contact.created""contact.updated""contact.tags_changed""broadcast.completed""broadcast.failed""template.status_changed""workflow.execution_failed""knowledge_file.ready""webhook.test"occurred_at*stringCuándo ocurrió.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$date-timeorganization_id*stringOrganización.
uuiddata*Recibido.
Solicitudes de ejemplo
El cuerpo JSON que Ricky envía al endpoint de un webhook.
/knowledge_file.ready