Développeurs

Brancher Temonis sur votre site et vos outils

Le widget qui affiche vos témoignages, les connecteurs qui récupèrent vos appels, et l'API qui permet à n'importe quel outil d'envoyer un transcript. Tout ce qu'un développeur ou une DSI doit savoir, sur une seule page.

Widget sans cookieConnecteurs en lecture seuleAPI d'entrée en JSONHébergé à Paris

Vue d'ensemble

Widget

Disponible à partir de l'offre Growth. La clé du widget se trouve dans votre espace, menu « Widget site ». C'est un identifiant public, en lecture seule : il ne donne accès qu'aux témoignages publiés.

Intégration par script

Meilleur rendu, s'adapte à la largeur de la page. Les styles sont isolés (Shadow DOM) et ne touchent pas au reste de votre site.

<div data-temonis-widget="VOTRE_CLE"></div>
<script src="https://app.temonis.com/widget.js" async></script>

Intégration par cadre isolé

Si votre politique n'autorise pas de script externe : aucun code de Temonis ne s'exécute sur votre page.

<iframe src="https://temonis.com/widget/cadre.html?cle=VOTRE_CLE"
        title="Témoignages clients" loading="lazy"
        style="width:100%;height:520px;border:0;"></iframe>

Domaines à autoriser

ModeDirective CSPSource
Scriptscript-srchttps://app.temonis.com
Scriptconnect-srchttps://uxneihvcukbgwbkkkknf.supabase.co
Scriptimg-srcdata: et https: (logos et photos)
Cadreframe-srchttps://temonis.com

Aucun cookie, aucun stockage dans le navigateur, aucune donnée de vos visiteurs collectée. Un compteur anonyme de vues par témoignage alimente les statistiques du widget. Le détail complet est sur la fiche technique du widget.

Connecteurs

Les connecteurs se branchent depuis votre espace, menu « Réglages », puis « Intégrations ». Ensuite, les appels utiles arrivent seuls : une IA repère ceux où un client décrit un résultat concret. Un mot-clé (par exemple « témoignage ») dans le titre, un tag ou une note force la rédaction d'un appel précis.

OutilConnexionCe que Temonis lit
Microsoft TeamsCompte Microsoft 365, accord de l'administrateur une seule foisTranscriptions des réunions que vous organisez, participants
Google MeetCompte Google WorkspaceTranscriptions des réunions, participants de l'invitation
ZoomApplication Zoom créée par votre administrateurEnregistrements cloud et leur transcription
ModjoClé API Modjo (administrateur ou manager)Appels, transcription, intervenants, tags
GongAccess Key et secret (administrateur technique)Appels, transcription, trackers
AircallAPI ID et token (administrateur), option AI AssistAppels tagués et leur transcription
HubSpotApplication Temonis, autorisation en un clicAppels transcrits, contacts, entreprises ; ajout d'une note au témoignage validé (offre Scale)
Chorus, SalesforceMise en service avec votre administrateurAppels transcrits et compte client associé

Les clés et jetons partent dans un coffre chiffré de la base et ne sont jamais réaffichés. La connexion se coupe à tout moment depuis votre espace ou depuis l'outil.

API d'entrée des transcripts

Pour tout outil sans connecteur : votre enregistreur d'appels, votre CRM, un script interne ou un outil comme Zapier. Une requête par appel. Le transcript entre dans la même file que l'import manuel : rédaction en quelques minutes, puis relecture et demande d'accord au témoin.

1. Créer une clé

Dans votre espace, menu « Réglages », puis « Intégrations », section « Clés d'API », bouton « Créer une clé ». La clé commence par tmn_ et ne s'affiche qu'une fois : copiez-la tout de suite. Cinq clés actives au maximum par entreprise.

2. Envoyer un appel

AdressePOST https://auth.temonis.com/rest/v1/rpc/recevoir_transcript
En-têtesapikey: CLE_PUBLIQUE (affichée dans la même section de votre espace)
Content-Type: application/json
CorpsJSON, champs ci-dessous
curl -X POST 'https://auth.temonis.com/rest/v1/rpc/recevoir_transcript' \
  -H 'apikey: CLE_PUBLIQUE' \
  -H 'Content-Type: application/json' \
  -d '{
    "p_cle": "tmn_…",
    "p_contenu": "Texte complet du transcript…",
    "p_entreprise_nom": "Cabinet Dupont",
    "p_contact_email": "jean.dupont@cabinet-dupont.fr",
    "p_id_externe": "identifiant-de-l-appel-dans-votre-outil",
    "p_outil": "zapier"
  }'

3. Tester sa clé sans rien envoyer

{ "p_cle": "tmn_…", "p_test": true }

Réponse : {"statut": "test_ok", "organisation": "…"}. Aucun appel n'est déposé.

Champs et réponses

ChampObligatoireContenu
p_cleOuiVotre clé d'API (tmn_…)
p_contenuOuiLe transcript complet, de 300 à 400 000 caractères
p_entreprise_nomOuiL'entreprise du client qui témoigne (2 à 120 caractères)
p_contact_emailNonL'e-mail du témoin, pour lui demander son accord
p_id_externeConseilléL'identifiant de l'appel dans votre outil : un appel envoyé deux fois n'est traité qu'une fois
p_outilNonLe nom de l'outil qui envoie (zapier, make, ringover…)
p_nomNonUn libellé affiché dans « Derniers imports »
p_testNontrue pour vérifier la clé sans rien déposer
RéponseSignification
{"statut": "recu", "id": "…"}Appel reçu, mis en file de traitement
{"statut": "deja_recu", "id": "…"}Même p_id_externe déjà reçu : rien n'est refait, rien n'est décompté
{"statut": "test_ok"}Clé valide (mode test)

Limites et erreurs

En cas d'erreur, le code HTTP est 400 et le message contient l'un de ces codes :

CodeCause
cle_invalideClé inconnue ou supprimée
transcript_trop_courtMoins de 300 caractères
transcript_trop_longPlus de 400 000 caractères
entreprise_invalideNom d'entreprise absent ou trop long
email_invalideAdresse e-mail mal formée
limite_journalierePlus de 20 appels reçus en 24 heures pour votre entreprise

Langue : transcripts en français. Formats acceptés : texte brut. Pour un fichier .vtt, .srt ou .docx, envoyez son contenu texte, ou passez par l'import manuel de l'espace qui lit ces fichiers.

Zapier, Make, n8n

  • Déclencheur : « nouvel appel » ou « nouvelle transcription » dans votre outil.
  • Action : requête HTTP (Webhooks) en POST, format JSON, vers l'adresse ci-dessus, avec l'en-tête apikey et les champs p_cle, p_contenu, p_entreprise_nom.
  • Conseil : passez l'identifiant de l'appel dans p_id_externe ; si le scénario se relance, l'appel ne sera pas traité deux fois.

Sécurité

  • Seule l'empreinte (SHA-256) de chaque clé est conservée : Temonis ne peut pas la réafficher.
  • Supprimer une clé coupe aussitôt les accès faits avec elle. Chaque création, suppression et réception est journalisée.
  • La clé publique de l'en-tête apikey n'ouvre rien à elle seule : sans clé tmn_ valide, aucune donnée n'est lue ni écrite.
  • Toutes les adresses sont en HTTPS. Données stockées à Paris.

Hébergement, prestataires, IA : tout est détaillé sur la page Sécurité et confidentialité.

Besoin d'aide

Un connecteur absent de la liste, un besoin d'intégration particulier, un questionnaire de votre DSI : écrivez à support@temonis.com. Nous répondons directement à votre équipe technique.

Version 1 · dernière mise à jour : 1er octobre 2026