Envía conversaciones desde cualquier herramienta
Si tu herramienta de soporte no es una de las que conecta Ferndesk, publica tus conversaciones como JSON en una URL y conéctala como punto de conexión de soporte. Fern las lee como cualquier otra herramienta de soporte para encontrar preguntas que no estén cubiertas en tu documentación. Usa tus herramientas de soporte como fuente explica qué hace Fern con ellas.
Ferndesk obtiene los datos de tu URL: le envía una solicitud GET y nunca escribe en ella. Un propietario o administrador puede conectarla en Integraciones, en Centros de ayuda, pegando la dirección como URL de origen. Para conectarla, se necesita una suscripción activa o una prueba.
La solicitud
GET https://example.com/support-endpoint.json?token=YOUR_SECRET&startDate=2026-11-20T02:00:00.000Z&limit=500Ferndesk conserva cualquier cadena de consulta que ya esté en tu URL y añade:
Parámetro | Qué significa |
|---|---|
| Devuelve las conversaciones con actividad a partir de este momento. Marca de tiempo UTC en formato ISO 8601. Ferndesk no filtra las fechas por su cuenta, así que tu punto de conexión debe hacerlo. |
| El número máximo de conversaciones que se devolverán. Las sincronizaciones diarias envían 500. Cuando Ferndesk comprueba la URL al conectarla, envía 1. |
Ferndesk no envía credenciales. Para proteger el punto de conexión, incluye un secreto largo en la cadena de consulta de la URL y compruébalo en tu sistema.
La URL debe resolver a una dirección pública. Se siguen las redirecciones hasta 5 veces.
No hay paginación: cada sincronización consta de una sola solicitud. Devuelve primero las conversaciones más recientes, porque Ferndesk conserva solo las primeras
limit.La respuesta puede tener un tamaño máximo de 25 MB.
La respuesta
{
"conversations": [
{
"id": "conv_1042",
"url": "https://support.example.com/conversations/1042",
"lastMessageAt": "2026-11-20T14:32:00Z",
"messages": [
{
"id": 1,
"role": "user",
"content": "How do I export my invoices?",
"createdAt": "2026-11-20T14:05:00Z"
},
{
"id": 2,
"role": "support_agent",
"content": "<p>Go to Billing and choose Export.</p>",
"createdAt": "2026-11-20T14:32:00Z"
}
]
}
]
}Campo | Reglas |
|---|---|
| Obligatorio. Una cadena no vacía que se mantiene igual en todas las sincronizaciones. |
| Opcional. Una URL absoluta a la conversación en tu herramienta. |
| Obligatorio. Formato ISO 8601 con zona horaria, como |
| Obligatorio. Una cadena no vacía o un número entero mayor o igual que 1. |
|
|
| Obligatorio. Texto sin formato o HTML simple. Se eliminan las demás etiquetas. |
| Obligatorio. Formato ISO 8601 con zona horaria. |
Si una conversación no cumple estas reglas, falla toda la respuesta, así que valídala antes de devolverla. Para informar de un problema en tu sistema, devuelve una cadena de nivel superior llamada "error": Ferndesk considera que la sincronización ha fallado.
Cuando Ferndesk sincroniza
Justo después de conectarla, Ferndesk comprueba la URL con
limit=1y un tiempo de espera de 10 segundos. Si la solicitud falla o el JSON no coincide con el formato esperado, no se guarda la conexión.La primera sincronización solicita los últimos 90 días. Después, Ferndesk sincroniza una vez al día y solicita las conversaciones posteriores a la última sincronización correcta.
Si una sincronización falla, se vuelve a intentar una vez.
Las conversaciones importadas aparecen en Informes > Temas, agrupadas por tema. Encuentra y soluciona las carencias de la documentación cada mes explica qué hacer con ellas.