Développeurs

La section Développeurs vous permet de créer des identifiants API pour intégrer Sonario avec vos propres applications.

Accès

Allez dans Paramètres > Développeurs pour accéder à cette page.

API Sonario

L'API Sonario permet de :

• Créer et gérer des conversations
• Créer et gérer des tickets
• Récupérer des informations visiteurs
• Automatiser des workflows

Identifiants OAuth

Créer une application OAuth

1. Cliquez sur Créer une application
2. Remplissez les informations :
   • Nom : Nom de votre application
   • Description : Description de l'usage prévu
   • URL de callback : URL de redirection OAuth
3. Cliquez sur Créer

Informations générées

Après création, vous obtenez :

• Client ID : Identifiant public de l'application
• Client Secret : Clé secrète (affichée une seule fois)

Important : Notez le Client Secret immédiatement, il ne sera plus affiché.

Utilisation

Utilisez ces identifiants pour :

• L'intégration Zapier
• Des intégrations personnalisées
• Des applications tierces

Clés API

Créer une clé API

1. Cliquez sur Créer une clé API
2. Donnez un nom à la clé
3. Sélectionnez les permissions :
   • Lecture seule
   • Lecture/Écriture
4. Cliquez sur Créer

Utilisation des clés

Incluez la clé dans l'en-tête de vos requêtes :

Authorization: Bearer sk_xxxxxxxxxxxx

Révoquer une clé

1. Trouvez la clé dans la liste
2. Cliquez sur Révoquer
3. Confirmez

La clé est immédiatement invalidée.

Webhooks

Configurer un webhook

1. Cliquez sur Ajouter un webhook
2. Entrez l'URL de destination
3. Sélectionnez les événements à écouter :
   • Nouvelle conversation
   • Nouveau message
   • Ticket créé
   • Ticket mis à jour
4. Cliquez sur Créer

Événements disponibles

Sécurité des webhooks

Chaque webhook inclut une signature pour vérifier l'authenticité :

1. Le header X-Sonario-Signature contient la signature
2. Vérifiez-la avec votre secret webhook

Documentation API

Consultez la documentation complète de l'API sur docs.sonario.app.

Bonnes pratiques

1. Ne partagez jamais vos secrets : Gardez le Client Secret et les clés API confidentiels
2. Rotation régulière : Changez vos clés périodiquement
3. Permissions minimales : N'accordez que les permissions nécessaires
4. Monitoring : Surveillez l'utilisation de vos clés
5. Révocation rapide : Révoquez immédiatement les clés compromises