API et webhooks
API prête pour la production. Il ne s'agit pas d'une diapositive de feuille de route.
Plus de 25 points de terminaison REST, webhooks en temps réel, authentification JWT et documentation interactive. Toutes les fonctionnalités de l'interface utilisateur sont accessibles via l'API.
Réponse rapide
Qu'est-ce que l'API DialerBee ? DialerBee fournit une API REST prête pour la production avec plus de 25 points de terminaison couvrant les campagnes, les contacts, les appels, les agents, la conformité, les enregistrements, les rapports et les webhooks. L'authentification utilise des jetons JWT valides pendant 24 heures. L'API prend en charge la pagination par curseur, renvoie des réponses d'erreur conformes à la RFC 7807 et limite à 2 000 requêtes par minute et par client. Les webhooks en temps réel transmettent des événements (call.started, call.answered, call.amd_result, disposition.set, compliance.blocked, etc.) avec vérification de signature HMAC-SHA256 et un délai de nouvelle tentative exponentiel. La documentation interactive de l'API est disponible à l'adresse dialer.broadnet.me/admin/api-docs.html.
Le problème
La plupart des API de numérotation sont une réflexion après coup
Vous avez acheté un composeur automatique pour passer des appels. Il vous faut maintenant l'intégrer à votre CRM, transférer les données vers votre entrepôt de données, déclencher des flux de travail à partir des événements d'appel et créer des tableaux de bord personnalisés. Vous consultez la documentation API du fournisseur et vous tombez sur… un PDF de 2019 avec 6 points de terminaison non documentés, aucun webhook et une interface SOAP.
C’est la réalité pour la plupart des équipes d’appels sortants. Le composeur fonctionne bien pour passer des appels, mais dès que vous avez besoin de… construire par-dessus — Synchroniser les dispositions avec Salesforce, créer automatiquement des tickets dans Zendesk, envoyer des analyses à votre outil de BI ou créer une interface d'agent personnalisée — vous êtes coincé avec des exportations CSV et des processus manuels.
DialerBee a été conçu selon une approche API-first. Chaque fonctionnalité de l'interface utilisateur repose sur la même API REST, accessible depuis vos systèmes. L'API n'est pas un module complémentaire : elle constitue le socle de toute la plateforme.
Comment ça marche
API-first par conception
L'API de DialerBee respecte les conventions REST avec des charges utiles JSON, des méthodes HTTP standard et des réponses d'erreur conformes à la RFC 7807. L'authentification utilise des jetons JWT obtenus via un point de terminaison de connexion, avec une expiration de 24 heures et la possibilité de renouveler les jetons. Chaque réponse de l'API inclut des en-têtes de limitation de débit permettant à votre intégration de gérer automatiquement le débit.
Authentifier
Envoyez une requête POST à /v1/login avec vos identifiants. Vous recevrez un jeton JWT valide pendant 24 heures. Utilisez la fonction d'actualisation du jeton pour les intégrations de longue durée.
Points de terminaison d'appel
Plus de 25 points de terminaison RESTful pour les campagnes, les contacts, les appels, les agents, la conformité, les enregistrements et les rapports. Entrée et sortie JSON.
Réception de webhooks
Enregistrez des URL de webhook pour recevoir des événements en temps réel. Chaque charge utile est signée avec HMAC-SHA256 afin que vous puissiez en vérifier l'authenticité.
Gérer les erreurs
RFC 7807 : Détails des problèmes pour chaque erreur. En-têtes de limitation de débit dans chaque réponse. Statut 429 avec instructions de nouvelle tentative.
Comparaison côte à côte
API DialerBee vs API de numérotation typiques
| Capacité | API de numérotation typique | API DialerBee |
|---|---|---|
| Points d'extrémité | 5-10, partiellement documenté | Plus de 25 documents entièrement documentés avec spécifications OpenAPI |
| Protocole | SOAP/XML ou propriétaire | REST avec JSON, erreurs RFC 7807 |
| Authentification | Clé API (n'expire jamais) | Jeton JWT avec expiration sous 24 h + actualisation du jeton |
| Événements en temps réel | Sondage ou pas | Webhooks signés HMAC-SHA256 avec nouvelle tentative |
| Pagination | À base de décalage ou aucun | Utilisation du curseur avec next_cursor + has_more |
| limitation de débit | Sans papiers | 2 000 requêtes/min avec en-têtes dans chaque réponse |
| Documentation | PDF ou wiki obsolète | Documentation Swagger interactive en direct |
| Immeuble multi-locataires | Locataire unique uniquement | Définition de la portée par locataire sur chaque point de terminaison |
Référence du point de terminaison
10 groupes d'API. Plus de 25 points de terminaison.
| Groupe API | Points d'extrémité |
|---|---|
| Authentification | POST /login, POST /refresh |
| Campagnes | CRUD + démarrage/pause |
| Contacts | Téléverser, lister, rechercher |
| Appels | L'histoire, les comptes en direct, l'origine |
| Agents | État, inscription SIP |
| Conformité et DNC | Vérifications préalables à la numérotation, listes d'opposition au démarchage téléphonique |
| Enregistrements | Liste des URL de lecture signées |
| Rapports | Exporter (CSV, JSON, PDF) |
| Webhooks | S'abonner, gérer, vérifier |
| Système | Santé, version |
Démarrage rapide
Authentifiez-vous et commencez à composer le numéro en 3 appels API
POSTE /v1/connexion
Type de contenu : application/json
{
"e-mail": "admin@yourcompany.com",
"mot de passe": "••••••••"
}
→ Réponse : { "jeton": "eyJhbG...", "expires_in": 86400 }POSTE /v1/campagnes
Autorisation : Porteur eyJhbG...
{
"nom": « Collections du 3e trimestre »,
"mode": "progressif",
"amd_enabled": true,
"profil_de_conformité": "uae-tdra"
}POSTE /v1/campagnes/{id}/contacts
Type de contenu : multipart/form-data
→ Importez un fichier CSV contenant le numéro de téléphone, le nom et les champs personnalisés.
POSTE /v1/campagnes/{id}/démarrage
→ La campagne est en cours d'appelWebhooks
Événements en temps réel livré à vos systèmes
Les webhooks transmettent des événements à vos systèmes en temps réel, sans interrogation périodique. Chaque charge utile de webhook est signée avec HMAC-SHA256 Vous pouvez ainsi vérifier que l'appel provient bien de DialerBee et n'a pas été altéré. Si votre point de terminaison est indisponible, les webhooks effectuent des tentatives de reconnexion avec un délai exponentiel pouvant aller jusqu'à 2 heures et 35 minutes, vous assurant ainsi de ne jamais manquer un événement.
appel.démarré Un nouvel appel sortant a été initié.
appel répondu Le destinataire a récupéré — la classification AMD était incluse
appel terminé Appel terminé : durée, résultat et URL de l’enregistrement
appel.amd_result Résultat de la classification AMD : humain ou machine, avec score de confiance
agent.changement_d'état L'agent est devenu disponible, de garde, en phase de finalisation ou hors ligne
disposition.ensemble L'agent a soumis une décision comportant le résultat et des notes.
conformité bloquée Un appel a été bloqué par le système de conformité avec les détails de la règle.
campagne.démarrée La campagne a commencé à composer les numéros
campagne.suspendue Campagne interrompue par le superviseur ou le système
enregistrement prêt L'enregistrement de l'appel est traité et prêt à être lu.
contact.dnc_ajouté Un contact a été ajouté à la liste de désabonnement du DNC
rappel.planifié L'agent a programmé un rappel pour un contact.
Cas d'utilisation
Construisez n'importe quoi au-dessus de DialerBee
Synchronisation CRM
Transférez les dispositions, les résultats des appels et les liens d'enregistrement vers Salesforce, HubSpot, Zoho ou tout autre CRM via des webhooks ou l'interrogation d'API.
BI et entrepôt de données
Exportez les données d'appels vers votre entrepôt de données. Créez des tableaux de bord dans Looker, Tableau, Power BI ou Metabase grâce à des exportations de rapports planifiées.
Flux de travail personnalisés
Déclenchez des actions dans vos systèmes lors d'événements d'appel : créez automatiquement des tickets d'assistance, mettez à jour les scores des prospects, envoyez des notifications Slack.
Appel en un clic
Utilisez le point de terminaison d'origine d'appel pour ajouter la fonction « cliquer pour appeler » depuis votre CRM, votre service d'assistance ou votre application personnalisée.
Synchronisation des contacts
Synchronisez vos listes de contacts avec votre source de données principale. Importez-les via un fichier CSV ou transférez les contacts individuellement via une API.
Automatisation de la conformité
Consultez le statut DNC avant les appels, gérez les listes de suppression et exportez les journaux d'audit de conformité par programmation.
Sous le capot
Conçu pour les développeurs qui expédient
| Protocole | HTTPS uniquement (TLS 1.2+) |
| Format | Corps de requête et de réponse JSON |
| Authentification | Jetons JWT Bearer (expiration sous 24 heures) avec actualisation |
| Versionnage | /v1 Chemin d'URL + version_schema dans les webhooks |
| Pagination | Utilisation du curseur avec next_cursor et has_more |
| limitation de débit | 2 000 requêtes/minute par locataire avec en-têtes |
| Format d'erreur | Détails du problème RFC 7807 pour les API HTTP |
| Signature Webhook | vérification de signature HMAC-SHA256 |
| tentatives de réapparition du webhook | Réduction exponentielle (maximum 2 h 35 min au total) |
| URL d'enregistrement | URL signées avec une expiration d'une heure via MinIO |
| listes d'opposition au démarchage téléphonique | Émirats arabes unis (TDRA), Arabie saoudite (CITC), Égypte (NTRA), Jordanie (TRC) |
| SDK | JavaScript et Python (bientôt disponibles) |
Fonctionnalités associées
Plateforme en marque blanche
API partenaire pour la gestion des locataires, la personnalisation de l'image de marque et la facturation.
Analyse et reporting
Exportez les données de vos rapports via API vers vos outils de BI.
Apportez votre propre porte-bagages
Gestion des liaisons SIP via panneau d'administration et API.
Intégrations
Connecteurs préconfigurés pour les CRM, la messagerie et bien plus encore.
Questions fréquentes concernant l'API
L'API est-elle disponible dans tous les forfaits ?
Où puis-je trouver la documentation de l'API ?
Comment fonctionne l'authentification par webhook ?
Que se passe-t-il si mon point de terminaison webhook est hors service ?
Puis-je utiliser l'API pour créer une interface d'agent personnalisée ?
L'API est-elle multi-tenant ?
Quelle est la limite de débit ?
Existe-t-il des kits de développement logiciel (SDK) disponibles ?
Prêt à intégrer ?
Explorez la documentation API en direct ou réservez une démonstration pour obtenir un accès API. Créez votre première intégration en quelques heures, et non en quelques semaines.