Support client
Freshdesk dans votre produit et vos agents IA, via une API
Le toolkit Freshdesk couvre les tickets et leurs conversations, les champs de ticket, les contacts et la recherche d'entreprises. Votre produit ou agent IA les appelle via Connect, qui stocke les identifiants du client et journalise chaque exécution, sans que vous construisiez l'intégration.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/freshdesk_create_ticket/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"requester_id": 1
}
}Fonctionnement
Du client connecté au premier appel à Freshdesk.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Freshdesk. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Freshdesk.
Ouvrir des tickets depuis votre produit
Un SaaS crée un ticket Freshdesk quand un utilisateur signale un problème, en identifiant le demandeur par e-mail pour créer un contact si besoin.
Copilote de support pour agents
Un agent IA recherche des tickets par statut ou priorité, lit la conversation et publie une note privée ou une réponse au demandeur.
Contacts toujours synchronisés
Un CRM ou outil de facturation crée et met à jour des contacts Freshdesk et les rattache à des entreprises trouvées par nom.
Tools
13 tools Freshdesk
- Lister les ticketsGETListe les tickets, les plus récents d'abord par défaut. Sans updated_since seuls les tickets créés dans les 30 derniers jours reviennent, et spam ou supprimés ne viennent qu'avec un filtre.
- Rechercher des ticketsGETRecherche des tickets avec une query de filtre, par exemple par statut, priorité, agent, groupe, tag ou champ personnalisé. Renvoie total et results, 30 tickets par page.
- Obtenir un ticketGETRenvoie un ticket avec status, priority, requester_id, responder_id, group_id, tags, custom_fields et description.
- Créer un ticketPOSTCrée un ticket. Identifiez le demandeur avec requester_id, email, phone ou unique_external_id ; un email ou phone absent de Freshdesk crée le contact.
- Mettre à jour un ticketPUTMet à jour un ticket : envoyez uniquement les champs à changer, et tags comme la liste complète que le ticket doit garder. Status 4 le résout et 5 le ferme.
- Lister les conversations d'un ticketGETListe les réponses et notes d'un ticket, avec body (HTML), body_text, private, incoming, user_id et source (0 réponse, 2 note). Les pages sont numérotées à partir de 1.
- Créer une réponse de ticketPOSTRépond au demandeur d'un ticket. Freshdesk envoie la réponse par e-mail au demandeur, elle est donc visible du client.
- Créer une note de ticketPOSTAjoute une note à un ticket. Les notes sont privées par défaut, visibles des agents seulement ; avec private à false le demandeur la voit aussi.
- Lister les champs de ticketGETListe les champs de ticket du helpdesk avec leurs choix : ids d'agents dans le champ agent, ids de groupes dans le champ groupe, ids de produits et valeurs de statut.
- Lister les contactsGETListe les contacts, les clients qui ouvrent des tickets, avec id, name, email, phone, mobile, company_id, tags et custom_fields. Les filtres se combinent.
Identifiant et mot de passe
Votre client saisit les identifiants de l'app sur un écran de Connect, ou votre système les envoie avec POST /api/customer-toolkits, sans écran.
À la connexion, votre client indique aussi {domain} : l'adresse de son compte sur l'API de l'app.
Questions sur le toolkit Freshdesk
Dois-je intégrer l'API Freshdesk moi-même ?
Non. Connect fournit 13 tools Freshdesk décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Freshdesk ?
Avec le mode accepté par le toolkit : Identifiant et mot de passe. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
