Envoyer des conversations depuis n’importe quel outil
Si votre outil d’assistance ne fait pas partie des outils auxquels Ferndesk se connecte, publiez vos conversations au format JSON à une URL, puis connectez-la comme point de terminaison d’assistance. Fern les lit comme n’importe quelle autre source d’assistance afin de trouver les questions auxquelles votre documentation ne répond pas. Utiliser vos outils d’assistance comme source explique ce que Fern en fait.
Ferndesk récupère les données à partir de votre URL : il lui envoie une requête GET et n’y écrit jamais. Un propriétaire ou un administrateur peut la connecter dans Intégrations, sous Centres d’aide, en collant l’adresse dans URL source. La connexion nécessite un abonnement ou une période d’essai actif.
La requête
GET https://example.com/support-endpoint.json?token=YOUR_SECRET&startDate=2026-11-20T02:00:00.000Z&limit=500Ferndesk conserve toute chaîne de requête déjà présente dans votre URL et ajoute :
Paramètre | Signification |
|---|---|
| Renvoyer les conversations qui ont eu de l’activité depuis cette date. Il s’agit d’un horodatage UTC au format ISO 8601. Ferndesk ne filtre pas lui-même les dates : votre point de terminaison doit le faire. |
| Le nombre maximal de conversations à renvoyer. Les synchronisations quotidiennes en envoient 500. Lorsque Ferndesk vérifie l’URL à la connexion, il en envoie 1. |
Ferndesk n’envoie aucun identifiant d’authentification. Pour protéger le point de terminaison, ajoutez un long secret à la chaîne de requête de l’URL et vérifiez-le de votre côté.
L’URL doit pointer vers une adresse publique. Les redirections sont suivies jusqu’à 5 fois.
Il n’y a pas de pagination : chaque synchronisation correspond à une seule requête. Renvoyez les conversations les plus récentes en premier, car Ferndesk ne conserve que les premières entrées selon
limit.La réponse peut peser jusqu’à 25 Mo.
La réponse
{
"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"
}
]
}
]
}Champ | Règles |
|---|---|
| Obligatoire. Une chaîne non vide qui reste identique d’une synchronisation à l’autre. |
| Facultatif. Une URL absolue vers la conversation dans votre outil. |
| Obligatoire. Format ISO 8601 avec un fuseau horaire, par exemple |
| Obligatoire. Une chaîne non vide ou un nombre entier supérieur ou égal à 1. |
|
|
| Obligatoire. Texte brut ou HTML simple. Les autres balises sont supprimées. |
| Obligatoire. Format ISO 8601 avec un fuseau horaire. |
Une conversation qui ne respecte pas ces règles fait échouer toute la réponse ; validez-la donc avant de la renvoyer. Pour signaler un problème de votre côté, renvoyez une chaîne de premier niveau nommée "error" : Ferndesk considère alors que la synchronisation a échoué.
Lors des synchronisations de Ferndesk
Juste après la connexion, Ferndesk vérifie l’URL avec
limit=1et un délai d’expiration de 10 secondes. Si la requête échoue ou si le JSON ne correspond pas au format attendu, la connexion n’est pas enregistrée.La première synchronisation porte sur les 90 derniers jours. Ensuite, Ferndesk effectue une synchronisation quotidienne et demande les conversations depuis la dernière synchronisation réussie.
Une synchronisation qui échoue est relancée une fois.
Les conversations importées apparaissent dans Rapports > Sujets, regroupées par thème. Repérer et combler les lacunes de la documentation chaque mois explique comment les exploiter.