Documentation développeurs
Tout ce qu'il vous faut pour connecter Deskwoot à vos outils. Ajoutez le widget de chat à votre site, ou pilotez conversations, contacts et boîtes de réception depuis votre backend.
Sur cette page
L'API REST permet à vos propres systèmes de créer des conversations et d'y répondre, de gérer les contacts et les attributs personnalisés, et de réagir aux événements de webhook. Vous vous authentifiez avec un jeton bearer issu de Paramètres → Jetons d'API. Chaque jeton a ses propres autorisations : une tâche de reporting peut avoir un accès en lecture tandis que l'intégration de votre back-office a un accès en écriture. Les jetons d'API font partie du forfait Enterprise.
Le widget JavaScript ajoute le chat en direct de Deskwoot à votre site web. Il s'agit d'une balise script et d'un petit objet de paramètres, et il apporte la messagerie en temps réel, les pièces jointes, la connexion vérifiée pour vos utilisateurs connectés et Fynn, notre agent IA. Pour plus de contrôle, par exemple ouvrir le chat depuis votre propre bouton ou connecter un utilisateur après le chargement de la page, le loader ajoute une petite API sur window.deskwoot.
Vous débutez ? Commencez par le widget : c'est un seul extrait de code dans le modèle de votre page. Passez à l'API REST quand vous voulez synchroniser les données de votre CRM ou ouvrir des conversations depuis vos propres applications.
Widget de chat JavaScript
Ajoutez le chat en direct de Deskwoot à votre site web. Collez un extrait de code, vérifiez les utilisateurs connectés et ouvrez le chat depuis vos propres boutons.
- Extrait d'intégration
- Options de configuration
- API JavaScript
- Vérification d'identité
- Notes sur la CSP
API REST
Un accès par programme aux conversations, contacts, boîtes de réception, équipes et plus encore. Authentifiez-vous avec un jeton d'API et pilotez Deskwoot depuis votre backend.
- Authentification
- Conversations
- Contacts
- Boîtes de réception
- Webhooks
À voir aussi dans le tableau de bord
Certaines intégrations se configurent directement dans votre tableau de bord Deskwoot :
- Paramètres → Webhooks
- Abonnez-vous aux événements de conversation, de message et de contact via des callbacks HTTP.
- Paramètres → Intégrations
- Connectez Shopify, Stripe et WooCommerce, publiez des alertes dans Slack et envoyez des événements à des milliers d'autres applications via Zapier.
- Paramètres → Jetons d'API
- Créez des jetons avec leurs propres autorisations pour l'API REST.
Il vous manque une intégration ou vous avez besoin d'aide pour connecter quelque chose ? Écrivez-nous à hello@deskwoot.com.
Questions fréquentes
Voici les réponses courtes. Pour tout le reste, demandez à Fynn ci-dessous.
Deskwoot a-t-il une API REST ?
Oui. L'API REST couvre les conversations, messages, contacts, boîtes de réception, agents, équipes, étiquettes, attributs personnalisés, règles d'automatisation, webhooks et articles du centre d'aide. La référence complète avec des exemples curl se trouve sur deskwoot.com/docs/api. Les jetons d'API font partie du forfait Enterprise.
Comment authentifier les requêtes API ?
Créez un jeton dans Paramètres → Jetons d'API et envoyez-le comme jeton bearer dans l'en-tête Authorization de chaque requête. Chaque jeton appartient à un espace de travail, a ses propres autorisations (comme read, write ou contacts:read) et peut être révoqué à tout moment sans toucher à vos autres jetons.
Existe-t-il des webhooks pour les nouvelles conversations et les nouveaux messages ?
Oui. Deskwoot envoie des webhooks quand une conversation est créée, mise à jour, attribuée ou résolue, quand un message est créé, quand un contact est créé ou mis à jour, et quand une enquête CSAT est envoyée. Vous ajoutez les URL de webhook pour tout l'espace de travail dans Paramètres → Webhooks et choisissez les événements de chaque URL. Chaque envoi comporte un en-tête X-Deskwoot-Signature (HMAC SHA256), pour que vous puissiez vérifier qu'il vient bien de nous.
Existe-t-il une spécification OpenAPI ou une collection Postman ?
Oui. La spécification OpenAPI 3.1 est publiée sur deskwoot.com/openapi.yaml. Importez-la dans Postman, Insomnia ou tout autre outil OpenAPI pour parcourir les endpoints ou générer un client dans votre langage.