Gestion des appels
Lancez un appel depuis votre logiciel (clic pour appeler), terminez l'appel en cours, transférez-le ou coupez le micro. Tous les points d'accès clé API (portée call; Authorization: Bearer bt_… dans l'en-tête, voir Sécurité de l'API) avec et GET est appelé avec la méthode.
Limite de débit : 10 requêtes par minute. L'identifiant d'appel (call_uuid)begin_callest renvoyé dans la réponse et dans les données d'appel en direct.
GETLancement d'appel (clic pour appeler)
Le poste indiqué sonne d'abord ; quand il décroche, le numéro de destination est appelé et les deux parties sont reliées.
GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567| Paramètre | Obligatoire | Description |
|---|---|---|
Authorization (objet) | oui | Bearer bt_…, portée call |
extension | oui | Poste auquel l'appel sera relié (ex. 1001) |
destination | oui | Numéro à appeler. Pour la Turquie 905321234567, pour l'international 00 + indicatif pays |
caller_id | non | Numéro affiché lors de l'appel sortant ; à défaut, la valeur par défaut du poste. Un numéro qui n'appartient pas à votre compte 400 renvoie |
manual_answer | non | true si c'est le cas, le poste doit décrocher manuellement ; à défaut, sur les appareils qui le prennent en charge, la réponse automatique est déclenchée |
timeout | non | Durée de sonnerie, 10-60 s (par défaut 30) |
announcement_to_caller | non | ID de l'annonce diffusée au poste à la connexion |
announcement_to_callee | non | ID de l'annonce diffusée à l'appelé à la connexion |
Réponse en cas de succès : 200 OK, l'identifiant d'appel dans le corps.
358c20bc-fd86-11e5-87a2-157d41a07454Exemples de réponses erronées :
400 Bad Request extension 1005 not found
400 Bad Request caller_id 02120000000 not allowed
401 Unauthorized Geçersiz anahtar: K…GETTerminer l'appel
GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>id à la place de, le format de chemin est aussi accepté : /api/hangup/<call_uuid>. Réponse 200 OK.
GETTransférer l'appel
Transfère l'appel en cours vers un poste ou un numéro externe.
GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002| Paramètre | Description |
|---|---|
id | Identifiant d'appel |
user_number | Poste de destination (ex. 1002) ou numéro externe (905321234567) |
GETCouper / réactiver le micro
GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=onstate: on (couper le micro) ou off (activer le son).
Données d'appels en direct
La liste des appels en cours (appelant, appelé, poste, statut, durée) se lit via le point d'accès du pont CRM ; utilisez ces données ou les webhooks pour ouvrir la fiche client à l'appel entrant. Pour plus de détails, demandez la documentation « Pont CRM » au Centre d'assistance ; le pont est prêt pour Byfix CRM.
Parcours type : clic pour appeler depuis le CRM
1. Kullanıcı CRM'de numaraya tıklar
2. Sunucunuz begin_call'u çağırır (extension = kullanıcının dahilisi)
3. Dahili çalar, açınca müşteri aranır; call_uuid'yi kaydedin
4. Görüşme bitince CDR raporda; kayıt panelden dinlenir