Intégration API Freshdesk
Nous développons votre connecteur Freshdesk
Nous relions votre produit à l'API Freshdesk v2 pour créer les tickets, lier les contacts et ramener le statut dans votre fiche client.
- Équipe produit senior
- connecteurs de support en production
- du cadrage au monitoring
À quoi sert l'intégration Freshdesk et que devient le support une fois connecté ?
Freshdesk est un outil de support client qui centralise les demandes reçues par email, chat, téléphone et formulaire. L'intégrer à votre application permet de créer un ticket automatiquement depuis votre produit quand un utilisateur signale un problème, de pousser les données du compte client dans la fiche du ticket sans que l'agent ait à les rechercher, et de rapatrier le statut de la demande dans votre interface. Le support arrête de vivre dans une boîte mail parallèle : il devient un objet métier visible dans votre produit, lié à l'historique du client.
Ce que nos clients branchent sur Freshdesk
Bouton Aide dans le SaaS
Le ticket part prérempli avec l'id compte, le plan et les derniers logs. L'agent n'interroge plus le client pour retrouver le contrat.
Statut ticket sur la fiche client
Un P1 ouvert bloque un geste produit, ou s'affiche dans le back-office. Le compte et le helpdesk parlent du même dossier.
Companies depuis le CRM
Les contacts entreprises sont provisionnés, puis les tickets routés par company_id. Plus de fiche en double entre le CRM et Freshdesk.
CSAT et time entries vers le BI
Export des scores et des temps passés, sans scraper l'UI. Un tableau de bord interne qui n'oblige pas à ouvrir Freshdesk.
Ce que ça change dans votre support
La technique au service d'un résultat mesurable : un ticket contextualisé, un contact unique, un support qui ne sature pas.
Fini le copier-coller d'incident
L'événement produit ouvre le ticket. Le support n'apprend plus l'incident par un canal parallèle, et l'agent voit le plan dès la première ligne.
Un contact, deux outils
On rapproche sur votre identifiant ou l'e-mail avant de créer. L'annuaire Freshdesk n'est plus pollué de doublons par l'intégration.
Le plafond d'appels est cadré
Le volume est partagé sur le compte, y compris les appels en erreur. On dimensionne le connecteur sur votre offre réelle.
L'accès ne meurt pas avec un agent
Compte technique, droits minimaux, rotation au départ. Un refus d'accès peut aussi dire « fonction absente du plan » : on le dit avant.
Comment nous livrons votre connecteur Freshdesk
Cadrage
Quels flux, quel rôle agent, quels champs custom, automations ou réconciliation périodique. On liste les cas limites avant d'écrire une ligne de code.
Développement
Client qui lit X-RateLimit-Remaining et Retry-After, file unique par compte, idempotence à la création, pagination via header link.
Recette
Création de ticket, merge, restore, contact déjà existant. On rejoue un 429 et un 403 « feature absente », pas seulement le 201 heureux.
Monitoring
Alerte sur 429 répétés, Remaining bas, automation en échec. Réconciliation périodique : le canal webhook n'est pas un bus d'événements Zendesk.
Ce que permet l'API Freshdesk
- Tickets et conversations
- CRUD, bulk, merge, restore, reply, note, time entries, satisfaction. Statuts 2/3/4/5, priorités 1 à 4, pièces jointes 20 Mo.
- Contacts et agents
- CRUD contacts, merge, soft delete et hard_delete, make_agent. Les droits API suivent le rôle agent : ce que l'UI refuse, l'API refuse.
- Include / embedding
- Des champs ont quitté le GET ticket par défaut. ?include=requester consomme un crédit d'API de plus par ressource. description n'est plus dans le list sans include.
- Automations
- /api/v2/automations/{type}/rules : type 1 création, 4 updates, 3 hourly. C'est le canal sortant officiel dans la référence v2, pas un bus d'events signé.
Le vocabulaire de l'API Freshdesk
- Statuts numériques
- Open 2, Pending 3, Resolved 4, Closed 5. Priorités 1 à 4. Sources Email 1, Portal 2, Phone 3, Chat 7. Un mapping texte naïf casse au premier PUT.
- unique_external_id
- L'identifiant métier du contact. C'est la clé d'idempotence entre votre app et Freshdesk, plus sûre que l'email seul.
- include
- Paramètre d'embedding. Chaque ressource embarquée consomme un crédit d'API supplémentaire. description a disparu du list tickets sans include (changelog 2018-11-30).
- X-RateLimit-Total
- Plafond réel du compte, plus Remaining, Used-CurrentRequest, Retry-After sur 429. C'est la source de vérité, pas une table Growth 100 vs 200.
- Clé d'agent
- Basic clé:X. Les droits suivent le rôle : un agent qui ne peut pas répondre dans l'UI ne le pourra pas via l'API. Rotation à chaque départ.
- Automation
- Le canal sortant de la référence v2 (types 1, 4, 3). Pas un équivalent de Zendesk Connect. Signature HMAC et retries : non confirmés dans la ref v2 relevée.
Les contraintes réelles de l'API Freshdesk
Le quota se lit sur le compte
Par compte, partagé, requêtes invalides incluses. Trial 50 / min. Pro 400, Enterprise 700. Growth : deux grilles officielles divergent. On lit X-RateLimit-Total, on ne copie pas un blog.
Les include facturent un appel de plus
Embarquer requester (et d'autres) consomme un crédit par ressource. Une synchro qui include partout est lente pour rien. description n'est plus dans le list par défaut.
Pas de bus webhooks dans la ref v2
Les callbacks passent par les automations. Nous ne promettons pas une API webhooks signée : HMAC, retries et fenêtre de 24 h ne sont pas confirmés dans la référence v2.
Le 409 n'est pas une erreur fatale
Email de contact déjà existant : chercher avant, traiter duplicate_value comme un hit. Créer un ticket par email crée le contact : une intégration naïve pollue l'annuaire.
API Freshdesk ou API Zendesk ?
Deux helpdesks, deux modèles d'intégration. Le bon choix dépend de votre parc et de la façon dont vous synchronisez le stock.
| Critère | FreshdeskCette page | ZendeskSupport entreprise |
|---|---|---|
| Tickets | Statuts numériques 2/3/4/5 | new/open/pending/hold/solved/closed |
| Synchro de stock | List paginé, include facturé | Incremental Export (cursor) |
| Webhooks | Automations, pas de bus dédié v2 | API webhooks + HMAC SHA-256 |
| Quota | Lu dans X-RateLimit-Total | 200 à 2 500 / min selon Suite |
| Identité | Contacts + Agents, 409 doublon | Users, create_or_update 5 / min / user |
| Anti-collision | Idempotence métier | safe_update + updated_stamp |
| Le bon cas | Helpdesk Freshworks déjà en place | Support entreprise, entrepôt, multi-agents |
Les trois (Freshdesk, Zendesk, Intercom) ne sont pas « un CRUD ticket + un user ». Freshdesk facture les include. Zendesk impose l'export incrémental. Intercom sépare conversation et ticket. C'est un arbitrage de cadrage.
Ce que nous mesurons sur une intégration Freshdesk
Les autres API de support
Si Freshdesk n'est pas le bon socle, ces options se discutent au cadrage.
FreshdeskNous développons votre connecteur FreshdeskCette page
ZendeskTickets vs Requests, Incremental Export, safe_update, webhooks HMAC.
IntercomConversations et tickets, région EU, webhooks SHA-1 via le Hub.On combine Freshdesk avec
La stack qui entoure Freshdesk sur nos projets.
Intégration Freshdesk : vos questions
Trois étapes. D'abord une clé d'agent en Basic, avec le rôle le plus étroit qui permet les flux visés. Ensuite le mapping : unique_external_id pour le contact, champs custom pour l'id interne du ticket, recherche avant création pour survivre au 409. Enfin un client HTTP qui pagine via header link, budgète les include, lit X-RateLimit-Remaining et Retry-After, et pousse les callbacks via automations plutôt que d'inventer un bus d'events. La partie sensible n'est pas le POST ticket, c'est le quota partagé et l'annuaire non pollué.
Il dépend du plan, il est par compte, et les requêtes invalides comptent. Trial : 50 appels / minute. Pro 400, Enterprise 700, Free 0. Sur Growth, le portail développeur et l'article support divergent (100 vs 200 / min, et des sous-limites list différentes). Nous ne publions pas un de ces deux chiffres comme vérité : on lit X-RateLimit-Total, Remaining et Retry-After sur votre compte, et on dimensionne la file en conséquence. Les sous-limites list tickets peuvent être plus basses que le plafond global.
Pas dans la référence API v2 relevée en août 2026. Les callbacks sortants passent par les automations (/api/v2/automations/{type}/rules). Nous ne promettons pas une signature HMAC ni une fenêtre de retries de 24 h : ces détails circulent hors doc développeur et n'ont pas été confirmés. En pratique : automations pour le temps réel, réconciliation périodique (updated_since) en filet, parce que ce n'est pas un bus d'événements Zendesk Connect.
Un premier flux utile, typiquement créer un ticket depuis le SaaS et ramener le statut sur la fiche, se livre en deux à trois semaines. Une chaîne contacts, companies, CSAT, automations et reprise d'historique demande plutôt six à huit semaines : les sous-limites list et le nettoyage d'annuaire pèsent autant que le code. Nous cadrons le périmètre en amont et vous donnons une estimation ferme avant de commencer.
Freshdesk si le helpdesk est déjà là et que vous voulez un CRUD tickets + contacts, en acceptant automations et headers de quota. Zendesk si vous avez besoin d'un export incrémental, de safe_update et d'un bus webhooks signé. Intercom si le produit vit dans le Messenger, avec tickets Inbox à côté des conversations, région EU. Traiter les trois comme le même connecteur est le piège du cadrage : include facturé, cursor et SHA-1 ne sont pas interchangeables.
Un projet d'intégration Freshdesk ?
Parlons-en. 30 minutes pour cadrer vos tickets, lire le quota réel du compte et vous dire franchement ce qui est faisable.
Parler de mon projet Freshdesk