Forum Keyyo - API

Information importante : évolution de sécurité sur nos accès HTTPS

Wed, 01 Apr 2026 15:47:23 +0200

Bonjour,

Dans le cadre du renforcement de la sécurité de nos services, les protocoles TLS 1.0 et TLS 1.1 ne seront plus supportés à compter du 30 avril 2026 sur certains accès, notamment api.keyyo.com et url.keyyo.com.
À compter de cette date, seules les connexions utilisant TLS 1.2 minimum seront autorisées.
Si vous utilisez des applications, bibliothèques ou frameworks anciens pour vos connexions HTTPS ou vos appels API, une mise à jour de votre environnement technique peut être nécessaire.

Nous vous recommandons de vérifier dès maintenant la compatibilité de vos outils avec TLS 1.2 afin d’éviter toute interruption de service après la mise en œuvre de cette évolution.

Notifications d'appels si messagerie vocale

Mon, 26 Jan 2026 16:55:23 +0100

Bonjour,

Nous utilisons l’API serveur “Notification d’appels” sur les lignes fixes de notre offre.

En horaires d’ouverture, tout fonctionne : nous recevons bien les événements SETUP/CONNECT/RELEASE sur notre callback, même lorsque l'appelant obtient uniquement le message lui indiquant de faire un choix pour accéder au service souhaité.

Callback URL configurée :
https://ndd.com/callbackurl.php?token=**...F_REPLACE_

Constat : dès que nous passons en profil “fermé” et que l’appel est redirigé directement vers la messagerie vocale, aucune notification n’est reçue (pas de hit sur le callback). À l’inverse, en profil “ouvert”, les notifications arrivent correctement.

Est‑ce normal que les appels dirigés vers la messagerie (profil fermé) ne génèrent pas de notifications ?

Existe‑t‑il une option pour forcer les notifications même en fermeture/renvoi vers messagerie ?

Faut‑il activer l’API serveur sur un autre objet (numéro d’accueil / messagerie / ACD) pour recevoir ces événements ?

Merci d’avance pour votre retour.
Cordialement.

Envoi de SMS via l’API

Tue, 23 Dec 2025 09:13:08 +0100

Bonjour, s’il vous plaît, j’aurais quelques questions concernant les API:
Le nombre de SMS gratuits inclus par ligne et pouvant être envoyés via l’API.
Le mode d’application de ce quota, est-il défini par ligne ou bien global à l’ensemble du compte.
Le numéro affiché comme expéditeur lors de l’envoi des SMS :
Les SMS sont-ils envoyés avec les numéros fixes rattachés aux lignes, commençant par 04 ou 09, ou avec un autre numéro.
Existe-t-il des restrictions techniques ou commerciales concernant l’utilisation de certains numéros comme expéditeur lors de l’envoi via l’API.
Merci d’avance.

[Résolu] Faire le lien entre les postes clients et les appels via l'API

Tue, 07 Oct 2025 17:15:23 +0200

Bonjour

Je récupère bien tous les appels entrants et sortants.
Nous avons une équipe de quelques personnes pour lesquels Keyyo est installé sur le poste client.
Est-ce que la seule information qui permet de faire le lien entre les postes clients et les appels est la valeur _ACCOUNT_ et si oui, est-ce qu'il faut que chaque poste client ait son compte ?

[RESOLU] Problème du format de l'heure lors de la récupération des appels

Tue, 02 Apr 2024 09:42:11 +0200

Bonjour,
Nous récupérons bien les appels via webhook par contre nous avons un souci de timestamp. (_TSMS_)
Suivant les appels des postes récupérés, il y a un décalage de jours ou d'heures.
Y'a-t-il une configuration de la date et l'heure sur les applications clientes à faire ?
Ou s'agit-il de la date et l'heure du poste ?
Merci pour votre aide.

Statistiques d'appel

Mon, 25 Sep 2023 10:46:56 +0200

Je récupère les statistiques par les routes
https://api.keyyo.com/manager/1.0/incoming_call_detail
https://api.keyyo.com/manager/1.0/outgoin_call_detail

Je recherche des statistiques complémentaires à la durée de communication.
- Temps de réponse
- Temps de mise en attente
- Déclenchement du répondeur, si basculement sur le répondeur

Visiblement, ce n'est pas présent dans ces rotues.
Est-ce qu'il y a un moyen d'obtenir ces données-là d'une autre façon ?

Remontée de fiche coté client

Tue, 25 Apr 2023 08:26:11 +0200

Bonjour,
Lors d'un appel client, notre application remonte les informations client par le biais de l'appel d'une URL en ouvrant le navigateur par défaut.
L'appel d'url est configuré sur le client décrochant l'appel.
Ceci fonctionne correctement avec l'application 3CX.
Nous voudrions faire de même avec nos clients Keyyo.
Suite discussion avec le support, celui me demande de vous soumettre la problématique car d'après leur retour, actuellement le dialogue ne peut se faire que de serveur à serveur mais pas de client web à serveur.
Nous avons tester en configurant dans le manager l'appel d'url sans résultat probant.
Pouvez-vous trouver une solution afin de reprendre l'existant et fonctionnement actuel par le biais du client web Keyyo.

Cordialement

Capture d’écran 2023-04-25 082516.png (Taille : 148,88 Ko / Téléchargements : 7)

Encoding SMS

Wed, 12 Apr 2023 15:50:05 +0200

Bonjour,

j'ai bien suivi les instructions vis à vis des caractères spéciaux du poste https://forum.keyyo.com/showthread.php?tid=1777

Voici le code PHP de test que j'utilise (la page de code est bien encodée en UTF-8):

Code :

$message = "test é à è @ '";

$account = "xxxxxxxxxxx";

$callee = "xxxxxxxxxxx";

$login = "xxxxxxxxxxx";

$password = "xxxxxxxxxxx";

$texte = urlencode(iconv("UTF-8", "ISO-8859-15", $message));

$url="https://ssl.keyyo.com/sendsms.html?ACCOUNT=$account&CALLEE=$callee&MSG=$texte";

$ch = curl_init();

// Typed'authentification

curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST);

// identifiant SIP Keyyo ":" Mot de passe SIP

curl_setopt($ch, CURLOPT_USERPWD, "$login:$password");

curl_setopt($ch, CURLOPT_URL, $url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$data = curl_exec($ch);

curl_close($ch);

if ($data !== 'OK') {

   throw new Exception('Erreur dans l\'API SMS Keyyo : ' . $data);

}

echo $data;

- aucun accent, @ et ' (par exemple) ne passent
- de plus les caractères comme ’ bloquent l'envoie du SMS, pourtant la réponse de l'API est bien OK mais aucun SMS n'est reçu.

Auriez vous une solution pour ces problèmes ?

merci

SIP Records incomplets

Fri, 07 Apr 2023 10:12:20 +0200

Bonjour,

Nous rencontrons un soucis d'utilisation pour récupérer les SIP-Records via « GET /services/:csi/sip_records »

Certains équipements et donc les informations liées ne remontent pas alors que les équipements sont bien présents sur l'UC-manager.

Sur les lignes concernées, aucun équipement ne s'affiche même si plusieurs téléphones sont enrollés

Merci d'avance
Cordialement

SMS envoyé aléatoirement

Fri, 31 Mar 2023 14:00:18 +0200

Bonjour,

en 2017, j'ai écris un programme en C# d'envoi de SMS qui donnait pleine satisfaction. Récemment, j'ai modifié ce programme pour prendre en compte un délai d'envoi entre chaque SMS de 15 secondes et une attente d'une minute après chaque groupe de 10 SMS.

Mes logs me disent que les SMS sont envoyés correctement. L'API me retourne OK pour chaque envoi.
Néanmoins, après comparaison avec le journal d'appel de la console Keyyo, il semblerait que la moitié (environ) ne soit pas envoyé.

La méthode utilisée est la suivante: https://ssl.keyyo.com/sendsms.html?ACCOU...taire>&
MSG=, comme précisé dans la doc.

Nous avons appelé l'un des numéros où le SMS n'est pas partit, pensant que le numéro n'existait plus. Ce n'est pas le cas.
Je précises que les envois ont lieu les jours ouvrés à 9h30.

Y a-t-il une explication ? Bloctel, peut-être ?
Que puis-je faire pour relancer l'envoi des SMS qui ne partent pas ?

Merci pour toute information.

Cordialement,
--
Marc

CTI Notification Appel / notifications non faites [Répondu]

Thu, 04 Aug 2022 15:11:20 +0200

Bonjour,

Depuis trois jours nous rencontrons des problèmes de réception des notifications d'appels.
Il y des notifications qui n'arrive jamais sur notre système. Nous n'avons fait aucun changement sur le paramétrage des lignes au niveau URL CTI.

Auriez-vous une solution a me proposer.

Merci

Bien à vous,

incoming_call_detail: certains journaux remontent, et certains non

Fri, 27 May 2022 13:44:54 +0200

Bonjour,
Nous téléchargeons le journal des appels entrants et sortants https://api.keyyo.com/manager/1.0/servic...all_detail
https://api.keyyo.com/manager/1.0/servic...all_detail

Tout marchait correctement, jusqu'au 18 Mai: nous avons ce problème.
Certaines lignes on obtient le journal des appels dans un fichier JSON. certaines on obtient une erreur
[
Gateway Timeout
The gateway did not receive a timely response from the upstream server or application.

]

Merci pour votre aide

Retour Erronée de l'api CLI JS

Fri, 18 Feb 2022 14:44:16 +0100

Bonjour
Nous utilisons l'api CLI-JS
"https://api.keyyo.com/developers/docs/api/cti-js/".
Dans la partie
cti.onNewCall = function(call) {
}
parfois l'évènement "onSetup ,onConnect,onRelease,onMissed" ne se lance pas.

Par conséquent, les informations retournées au niveau de notre ERP sont erronées.

1. le nombre d'appels est incorrect

2. les appels reçus sont affichés en tant que des appels manqués

3. Certains appels de Keyyo phone ne sont pas détectés par l'API

Nous sommes actuellement bloqués et ce depuis quelques jours.
Merci de nous donner une solution .

[Manager API] Les appels entrants de certaines lignes ne remontent pas

Tue, 14 Dec 2021 10:55:35 +0100

Bonjour,

Les appels entrants de deux de nos numéros d'accueils sont impossible à récupérer via l'API incoming_call_detail des Manager API.

Nous effectuons régulièrement des appels sur cette api pour détecter les appels manqués sur nos lignes et sur la journée du 13/12 aucun appel ne remonte lorsque nous requêtons cette API pour deux de nos six numéros d'accueil.
Sur une des deux lignes, il y a eu 60 appels enregistrées dans la journée du 13/12.

Pour info, la requête que nous effectuons par exemple est la suivante :
https://api.keyyo.com/manager/1.0/servic...il?filters[limit]=1&filters[offset]=0&filters[date_start]=2021-12-13 00:00:00&filters[date_end]=2021-12-13 23:59:59&unit=second

Y-a-t-il une raison pour laquelle ces appels sont introuvables ?

Bonne journée et merci d'avance pour votre réponse.

resultat_api_call.PNG (Taille : 26,87 Ko / Téléchargements : 5)

Problème réception notifications CTI API v1 [Répondu]

Tue, 19 Oct 2021 11:49:38 +0200

Bonjour, depuis le 18/10 vers midi nous rencontrons des soucis de réception des notifications SETUP/CONNECT/RELEASE.
J'ai ouvert un ticket, un technicien a fait des tests.
Pour lui rien d'anormal de votre côté, le soucis doit venir de notre réseau local. Sur notre réseau local, tests effectués depuis 2 boxes différentes (une fibre RED et une box Keyyo) : avec les 2 nous avons les mêmes problèmes..
De plus, notre URL de notification reçoit des requêtes d'une vingtaine de téléphones tous à des endroits géographiques différents et tous rencontre le soucis.

Parfois nous recevons CONNECT/RELEASE mais pas SETUP... parfois rien du tout.

Si je vous donne un appel précis, pourriez-vous voir dans vos logs si un problème est présent chez vous ? (ce qui est ma première hypothèse car de notre côté le problème est survenu d'un coup sans aucune modification et à 20 endroits géographiques différents).

Mise en place d'une Api vers notre CRM [Répondu]

Wed, 25 Aug 2021 18:59:39 +0200

Bonjour,

Nous souhaiterions connecter notre outils keyyo à notre crm. Nous aimerions savoir comment il serait possible qu'un appel décrocher par un de nos commerciaux génère automatiquement la création d'une fiche client.

Serait-il possible de mettre en relation un de vos développeur avec un développeur de notre Crm afin de réaliser ce projet ?

Merci d'avance,

Erreur RPC invalid params [Répondu]

Wed, 07 Jul 2021 10:34:52 +0200

Bonjour,

Nous souhaitons implémenter la solution CTI JS mais nous nous heurtons à des difficultés.

Toute la partie "basics steps" est en place et nous récupérons bien un token CSI.
Lorsque nous souhaitons l'utiliser pour lancer un appel (cti.dial), nous avons une erreur "RPC invalid params". Nous n'avons pas plus de détail.

N'avez-vous pas un dépôt GIT (à jour) avec des exemples d'implémentations ?
Merci pour votre retour.
Bonne journée.

Besoin particulier : possible avec l'API client ? [Répondu]

Thu, 17 Jun 2021 11:58:15 +0200

Bonjour,

Nous sommes une entreprise disposant de plusieurs typologies de lignes chez vous :
- 60 lignes fixes :
=> certaines liées à des combinés physiques
=> d'autres non et qui ne servent qu'à transférer des appels vers d'autre numéro
- 10 numéros d'accueil
- 2 numéros spéciaux

Notre besoin : un appel entrant sur une de ces lignes doit générer une requête vers notre application web qui décidera ensuite du numéro vers lequel transférer cet appel.

Est-ce possible avec l'API client étant donné qu'une grosse partie de nos lignes ne sont liées à aucun combiné physique ?
Si non, comment arriver à nos fins ?

Merci par avance.

Envoi de SMS via FortiAuthenticator [Répondu]

Wed, 12 May 2021 09:47:17 +0200

Bonjour,
Je souhaite utiliser l'API d'envoi de SMS pour envoyer des SMS pour de la double authentification VPN.
J'utilise le produit FortiAuthenticator de la société Fortinet.
Avant de parametrer le produit en lui même, je n'arrive pas à envoyer de SMS via l'URL indiquée dans la documentation.
Voici l'url que j'utilise :
https://ssl.keyyo.com/sendsms.html?ACCOU...*&MSG=test
le résultat est : Invalid LineID
Si j'envoi cette url :
https://ssl.keyyo.com/sendsms.html?ACCOU...*&msg=test
Le résultat est Invalid parameters
Il semble donc que l'url soit case sensitive mais dans les 2 cas, ça ne fonctionne pas.
Pouvez vous me dire ce qui coince ?

Api sdk client js

Thu, 22 Apr 2021 15:24:52 +0200

Bonjour,
je suis heureux d'enfin avoir accès au forum j'aurais quelque petite question

1 - votre lien github d'exemple https://github.com/Keyyo/keyyo-cti-js-client

question auriez vous une plus récente version ? car plus rien de cette doc fonctionne

2 - le onRelease

j'ai entré ceci

Code :

call.onRelease = function(data) {

console.log("appel terminé "+data);

 }

je tente de récupérer des données mais rien est retourné par l'api c'est normal ?

votre doc sur les fonction est fourni ok mais des exemples concret pour récupérer les évènement

3 - est il possible d'envoyé des commande sur le pad de keyyo phone ? exemple j'appel mon client je tombe sur sont serveur vocal qui dit entrez le 1 pour avoir telle service je parle bien sûr à travers l'interface web merci

4- exemple

Code :

var timer = null;

var call = cti.get_call("")

clearInterval(timer);

timer = setInterval(function() {

    console.log(call.get_ringing_duration());

}, 1000);

où puis je récupérer ce fameux call ref Id null part est indiqué comment le récupérer

bref vous seriez gentil de me fournir un script d'exemple à jour correspondant à la version 1.1 de l'api