Centre développeurs

Faites de votre standard une partie de votre logiciel.

Une seule clé API, HTTP simple, réponses JSON. Du clic pour appeler et du contrôle d'appels aux campagnes d'appels automatiques, des missions de l'assistant vocal au code de vérification vocal, tout est REST ; les résultats reviennent par webhooks signés HMAC.

Démarrage rapide

Votre première requête en 2 minutes

Obtenez votre clé depuis Panneau > Appels automatiques > onglet API (ou depuis les Paramètres du standard) ; envoyez-la avec l'en-tête Bearer, X-Api-Key ou ?key=.

La clé est liée à votre compte client ; elle ne peut pas accéder aux données d'un autre client.
Les opérations de lecture sont en GET, celles qui modifient en POST ; corps en JSON ou formulaire.
La réponse d'erreur contient toujours {"ok":false,"error":"…","code":"…"} est de la forme.
Limite de débit : 120 requêtes par minute et par clé ; en cas de dépassement 429.

Lire la vue d'ensemble Faire une demande

# clic pour appeler : le poste 1001 sonne d'abord, la destination est appelée dès qu'il décroche curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # créer la campagne curl -X POST "https://api.buluthat.com/api/autocall.php?action=create_campaign" \ -H "Authorization: Bearer bt_xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"name":"Ödeme hatırlatma","campaign_type":"ivr", "tts_template":"Merhaba {sayin}, {tutar} tutarındaki ödemeniz…", "digit_labels":{"1":"Ödedim","2":"Yetkili"}}' # envoyer un code de vérification vocal curl -X POST "https://api.buluthat.com/api/voice_otp.php?action=send" \ -H "X-Api-Key: bt_xxxxxxxx" -d "phone=905321234567" → {"ok":true,"id":8812,"code":"472915","expires_in":300}

Documentation

En-têtes de l'API

Pour chaque rubrique : adresse du point d'accès, paramètres, exemple de requête et de réponse.

Vue d'ensemble

Authentification, format des requêtes, codes d'erreur, limites de débit

Lire

Sécurité de l'API

Clés et portées, IP autorisées, signature HMAC des requêtes, renouvellement des clés, journal des requêtes

Lire

Gestion des appels

Clic pour appeler, terminer, transférer, couper le micro

Lire

Files d'attente

Liste des files, appels en attente, ajout/retrait de membres

Lire

Statuts des agents

Statuts des postes et appartenances aux files

Lire

Liste noire

Lister, ajouter, supprimer les numéros bloqués

Lire

Fichiers audio

Liste des annonces, envoi, mise à jour, suppression

Lire

Appels automatiques

Créer une campagne, ajouter des numéros, obtenir les résultats, webhook

Lire

Assistant vocal

Conversations, notes, rendez-vous, appel de mission, intégration

Lire

Vérification vocale (OTP)

Envoyer un code, vérifier, statut, webhook

Lire

API SMS

SMS en masse / personnalisés, SMS OTP, rapport de remise, SMS entrants, liste noire

Lire

Webhooks

Vérification de la signature, politique de nouvelle tentative, schémas d'événements

Lire

Intégration (iframe CRM)

Dans les écrans de la centrale et votre logiciel de WebPhone : code, lien signé, événements JavaScript

Lire

Webhooks

Que les résultats viennent à vous, sans que vous ayez à demander.

Résultat d'appel automatique, résumé de conversation de l'assistant vocal, état du code de vérification — chaque événement est envoyé en POST JSON à votre adresse ; l'en-tête X-Buluthat-Signature est la signature HMAC-SHA256. Une livraison échouée est retentée à intervalles de 1 min → 6 h.

Documentation des webhooks

// PHP : vérification de la signature $raw = file_get_contents('php://input'); $sig = $_SERVER['HTTP_X_BULUTHAT_SIGNATURE'] ?? ''; $calc = hash_hmac('sha256', $raw, $secret); if (!hash_equals($calc, $sig)) { http_response_code(401); exit; } $event = json_decode($raw, true); // $event['event'] = 'call_finished' | 'session_ended' | 'otp_result' …

Pont Byfix CRM

L'assistant vocal trouve le client dans le CRM, ouvre un dossier de service, laisse une note ; l'appel « avec l'assistant » se lance depuis le CRM. Prêt à l'emploi, une seule clé.

Détail

Client PHP

Classe PHP prête à l'emploi pour le code de vérification vocal ; envoi/vérification en deux lignes. Les autres points d'accès étant du HTTP simple, ils s'appellent depuis n'importe quel langage.

Exemple

Écran en direct intégrable

Transcription en direct de la conversation de l'assistant dans le CRM via iframe ; par jeton signé à durée limitée, sans session sur le panneau.

embed_url