Canal

API de support client pour des intégrations et des canaux personnalisés

L'API de support client de Deskwoot couvre les conversations, les contacts, les messages, les agents, les étiquettes et les attributs personnalisés. Créez des canaux personnalisés, un chat dans votre app ou un routage d'alertes par-dessus la boîte de réception partagée.

Gratuit pendant 7 jours, pour 30 membres de votre équipe au maximum. Sans carte bancaire.

Vue d'ensemble

API en détail

Beaucoup de helpdesks traitent l'API comme un détail et oublient les endpoints dont vous avez vraiment besoin. L'API de support client de Deskwoot est incluse dans le forfait Enterprise et couvre les conversations, les messages, les contacts, les boîtes de réception, les étiquettes, les équipes, les webhooks et plus encore, le tout documenté dans une spécification OpenAPI.

REST et webhooks : conversations, contacts, messages, étiquettes, équipes, attributs personnalisés et plus encore sont disponibles via REST. Les webhooks envoient à votre URL des événements comme une conversation créée, attribuée ou résolue, les nouveaux messages, les changements de contact et les notes CSAT, signés avec votre secret, pour que votre code réagisse aux événements au lieu d'interroger sans cesse. Si les tickets sont activés, les événements des tickets peuvent aussi y être envoyés.

Authentification : des jetons d'API avec des autorisations. Donnez à chaque intégration seulement ce dont elle a besoin, par exemple un accès en lecture, ou l'autorisation dédiée qui permet de publier des messages de clients dans une boîte de réception API.

Canaux personnalisés : créez une boîte de réception API REST, envoyez-y les messages de vos clients avec votre propre ID par message et définissez une URL de callback. Une requête renvoyée ne crée jamais de doublon, et les réponses des agents et de Fynn sont envoyées à votre URL de callback : le chat dans votre app ou tout canal non intégré fonctionne donc comme les autres.

Les usages courants que nous voyons : 1) un chat dans une app mobile, où votre backend envoie les messages à une boîte de réception API, 2) un formulaire de contact sur votre site qui ouvre une conversation via l'API, 3) des alertes d'appareils ou de systèmes qui arrivent dans la boîte de réception sous forme de conversations, 4) la synchronisation des contacts et des données de conversation avec vos propres systèmes.

Ce que vous obtenez

Ce que vous apporte le support via API

REST et webhooks

Lisez et écrivez des conversations, des contacts et des messages, et recevez des webhooks pour les événements.

Nouvelles tentatives sans risque

Chaque message entrant porte votre propre ID : une requête renvoyée ne crée donc jamais de doublon.

Jetons d'API avec autorisations

Chaque jeton reçoit seulement les autorisations dont une intégration a besoin.

Spécification OpenAPI

La référence complète se trouve sur /docs/api, avec un fichier OpenAPI pour Postman, Insomnia ou votre propre générateur de client.

Callbacks pour les réponses

Définissez une URL de callback sur la boîte de réception API, et les réponses des agents et de Fynn sont envoyées à votre système.

Connexion

Prêt en 3 étapes

  1. Avec le forfait Enterprise, créez un jeton d'API dans Paramètres → Jetons d'API.
  2. Créez une boîte de réception API REST et envoyez les messages des clients à son endpoint de réception.
  3. Définissez une URL de callback pour recevoir les réponses.

QUESTIONS

Questions fréquentes

Quelle est la meilleure API de support client pour des intégrations personnalisées ?

Pour des canaux personnalisés, une API de support client doit offrir : des endpoints pour les conversations et les contacts, des webhooks pour les événements, des jetons avec autorisations, des nouvelles tentatives sans risque et une bonne documentation. Deskwoot propose tout cela dans le forfait Enterprise, avec une spécification OpenAPI. Zendesk et Intercom ont aussi des API solides.

Comment créer un canal personnalisé avec l'API ?

Créez une boîte de réception API REST dans Paramètres → Boîtes de réception avec une URL de callback. Envoyez les messages des clients à https://api.deskwoot.com/v1/accounts/{accountId}/inbound avec un jeton qui a l'autorisation inbound:ingest, et les réponses des agents et de Fynn sont envoyées à votre URL de callback. Deskwoot s'occupe de la boîte de réception, de l'IA, des SLA et des rapports.

L'API de support client a-t-elle des limites de requêtes ?

Oui. Les requêtes sont limitées par jeton, par exemple 120 messages entrants par minute, et une requête au-delà de la limite reçoit une réponse 429.

Quels événements les webhooks envoient-ils ?

Les webhooks couvrent les principaux événements : conversation créée, mise à jour, attribuée et résolue, message créé, contact créé et mis à jour, et note CSAT envoyée. Si les tickets sont activés, un webhook peut aussi recevoir ticket créé, mis à jour, attribué et résolu. Chaque envoi est signé avec votre secret de webhook et renvoyé une fois si votre endpoint échoue.

Puis-je utiliser l'API pour migrer depuis un autre helpdesk ?

Pour la plupart des migrations, vous n'avez pas besoin de l'API : Paramètres → Import récupère les contacts et les conversations depuis Chatwoot, Zendesk, Freshdesk, Intercom et Crisp, et un import CSV couvre les contacts venant de n'importe où ailleurs. L'API sert pour les données d'autres systèmes.

Essayez gratuitement
pendant 7 jours

Commencer l'essai gratuitGratuit pendant 7 jours, pour 30 membres de votre équipe au maximum. Sans carte bancaire.Voir les tarifs

Démo interactive de Deskwoot