API et intégrations

Tout ce que permettent les pages Appels et Service client peut aussi être fait depuis vos propres systèmes : un service d’assistance, un site web, un système téléphonique ou votre propre logiciel. Dans le tableau de bord, ouvrez API et intégrations. Seuls les propriétaires et les administrateurs de l’organisation peuvent gérer ces intégrations ; tout ce qui est effectué par leur intermédiaire est facturé à l’organisation comme si la même opération avait été faite dans le tableau de bord.

Les détails techniques, les exemples et la référence complète de l’API sont disponibles dans la documentation pour les développeurs. Cet article explique à quoi sert chaque partie.

Intégrations prises en chargeDemander

Spiiksi fonctionne avec les outils suivants. La documentation pour les développeurs propose un guide pas à pas pour chacun d’eux.

Vous les trouverez toutes dans la liste des connecteurs. Les appels démarrés par une intégration apparaissent sous Appels, où les agents peuvent les rejoindre.

Configurer les numéros de téléphone et Teams

Twilio, SIP et Teams se configurent dans le tableau de bord, sous Connecteurs, sur la page API et intégrations :

• Twilio : saisissez vos informations Twilio, cliquez sur Connecter, puis collez l’URL du webhook vocal (à coller dans Twilio) dans les paramètres de votre numéro sur Twilio.
• SIP : créez un identifiant d’entrée et copiez le plan de numérotation dans votre autocommutateur.
• Teams : créez un webhook sortant dans l’équipe et collez son jeton de sécurité.

Configurer les applications de service d’assistance

Zendesk, Freshdesk, Salesforce et Genesys Cloud s’installent dans les outils correspondants. Créez une clé API pour l’application (voir ci-dessous), téléchargez l’application depuis son guide et suivez les étapes indiquées.

Clés APIDemander

Vos systèmes utilisent une clé API pour communiquer avec Spiiksi. La page Authentification explique comment transmettre les clés avec chaque requête.

1. Sous Clés API, indiquez à quoi sert la clé, par exemple « Zendesk ».
2. Choisissez le Mode : En direct pour une utilisation réelle, ou Test pour faire des essais (voir ci-dessous).
3. Sous Autorisations de la clé, laissez toutes les options activées ou autorisez uniquement les actions nécessaires au système, par exemple traduire du texte seulement ou consulter les appels seulement.
4. Cliquez sur Créer une clé et copiez-la immédiatement. Elle ne s’affichera plus ; conservez-la sur votre serveur, jamais sur une page web.

Révoquer désactive immédiatement une clé, par exemple si vous pensez qu’elle a été divulguée. La liste indique la date de dernière utilisation de chaque clé.

Mode testDemander

Avec une clé Test, les textes reçoivent une traduction simulée, les voix des appels sont transmises sans traduction et rien n’est facturé. La clé ne donne accès qu’aux données créées par des clés de test, jamais à vos véritables appels et conversations. Utilisez-la pendant le développement d’une intégration, puis passez à une clé En direct.

WebhooksDemander

Un webhook informe votre serveur lorsqu’un événement se produit : un appel commence ou se termine, un chat démarre, reçoit un message ou se ferme.

Consultez la page Webhooks de la documentation pour les développeurs pour connaître le contenu de chaque notification et savoir comment vérifier sa signature.

1. Sous Webhooks, saisissez l’Adresse du webhook de votre serveur, choisissez les Événements (ou Tous les événements), puis cliquez sur Ajouter un webhook.
2. Copiez le secret de signature. Il ne s’affichera plus ; votre serveur s’en sert pour vérifier que chaque notification provient bien de Spiiksi.
3. Tester envoie une notification de test et affiche la réponse de votre serveur.

Si votre serveur ne répond pas, Spiiksi réessaie en espaçant de plus en plus les tentatives, pendant environ un jour et demi. Envois affiche chaque tentative et indique si elle a abouti ; Renvoyer permet de relancer un envoi. Après dix échecs consécutifs, le webhook est mis en pause. Réactivez-le à l’aide de son interrupteur Actif lorsque votre serveur fonctionne à nouveau.

Applications OAuthDemander

Une application OAuth est destinée aux logiciels auxquels plusieurs organisations se connectent, comme une application proposée dans la place de marché d’un service d’assistance. Au lieu de transmettre une clé API, l’administrateur de chaque organisation autorise l’application dans Spiiksi et peut la déconnecter à tout moment.

• Si vous créez une telle application : consultez la page OAuth de la documentation pour les développeurs, puis enregistrez l’application sous Applications OAuth en renseignant son Nom de l’application et ses URI de redirection (https, séparés par des espaces). Vous recevrez un ID client et un Secret client.
• Si vous connectez l’application de quelqu’un d’autre : Spiiksi indique les actions souhaitées par l’application et l’organisation concernée ; cliquez sur Autoriser. Les applications connectées sont répertoriées sous Applications connectées à cette organisation. Cliquez sur Se déconnecter pour révoquer immédiatement leur accès.

Chat sur votre site web et intégration à vos pagesDemander

• Un bouton de chat sur votre site web ouvre des conversations dans le Service client ; consultez Service client.
• Vous pouvez aussi intégrer des appels et des chats à vos propres pages, dans une fenêtre contextuelle ou dans une partie de la page, grâce au SDK JavaScript (/docs/javascript-sdk).

SécuritéDemander

• Conservez les clés API et les secrets sur votre serveur. Toute personne disposant d’une clé peut l’utiliser, et les frais sont facturés à votre organisation.
• Attribuez à chaque système sa propre clé, avec uniquement les autorisations dont il a besoin. Vous pourrez ainsi en révoquer une sans interrompre les autres.
• Spiiksi ne stocke qu’une empreinte de chaque clé API et secret client d’application, et non la clé elle-même ; c’est pourquoi ils ne peuvent pas être affichés à nouveau.