REST et webhooks
Lisez et écrivez des conversations, des contacts et des messages, et recevez des webhooks pour les événements.
Canal
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
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
Lisez et écrivez des conversations, des contacts et des messages, et recevez des webhooks pour les événements.
Chaque message entrant porte votre propre ID : une requête renvoyée ne crée donc jamais de doublon.
Chaque jeton reçoit seulement les autorisations dont une intégration a besoin.
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.
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
QUESTIONS
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.
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.
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.
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.
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.
À voir aussi