Open in

Référence des paramètres de l’organisation

Gérez une organisation ThunderPhone : profil, langue du tableau de bord, membres, confirmation des appels sortants, appelants bloqués, webhooks, SSO, clés API, alertes, facturation, limites de dépenses et historique.

Ouvrez les Paramètres de l'organisation (/dashboard/organization) pour gérer l'organisation active et votre propre compte. Les paramètres sont répartis dans six onglets ; votre rôle détermine les contrôles que vous pouvez modifier.

Mon compte

L'onglet Mon compte contient les paramètres de l'utilisateur connecté, et non ceux de l'ensemble de l'organisation :

Prénom, nom, e-mail et URL d'avatar.
Langue d'affichage du tableau de bord.
Téléchargement de l'application de bureau macOS.
Ajouter, vérifier, lister et supprimer des clés d'accès.
Préférences de cookies.
Se déconnecter sur l'appareil actuel.

Lorsque vous vous connectez via le SSO de l'organisation, le fournisseur d'identité gère votre e-mail, qui est en lecture seule ici. Consultez Compte et sécurité pour le processus détaillé des clés d'accès et du profil.

Général

Conformité des appels sortants

Pour les organisations auxquelles l'exigence s'applique, un propriétaire ou un administrateur doit examiner et enregistrer la confirmation unique des appels sortants avant que les agents puissent effectuer des appels sortants. Les membres peuvent voir qu'une action est requise, mais ne peuvent pas l'envoyer. Consultez Lois sur les appels sortants.

Rapports

Le fuseau horaire, les heures ouvrées hebdomadaires et les numéros de test de l'organisation. Les heures ouvrées déterminent quels appels sont comptabilisés comme ayant lieu hors des heures ouvrées dans les chiffres des rapports d'appels sur Accueil, dans l'onglet Appels de chaque agent et dans les Portails clients, ainsi que dans le filtre Heures ouvrées de l'Historique des appels. Lorsqu'aucun jour n'est coché, les appels hors des heures ouvrées ne sont pas suivis et chaque appel est comptabilisé comme ayant lieu pendant les heures ouvrées. Les appels provenant d'un numéro de test ou à destination d'un numéro de test sont exclus de tous les décomptes des rapports, des listes de portails, des chiffres de la Vue d'ensemble et des exportations CSV ; ils ne peuvent pas être ouverts dans un portail. Un agent peut avoir son propre fuseau horaire et ses propres heures sous Rapports dans l'éditeur d'agent, qui s'appliquent alors uniquement aux appels de cet agent.

Les propriétaires et les administrateurs modifient ces paramètres sous Général → Rapports. Choisissez le fuseau horaire et cochez chaque jour d'ouverture, puis saisissez ses heures d'ouverture et de fermeture. Sous Numéros de test, saisissez chaque numéro et choisissez Ajouter. Choisissez ensuite Enregistrer les paramètres de rapports. Tant qu'un fuseau horaire n'est pas enregistré, les rapports utilisent UTC ; la page suggère le fuseau horaire de votre navigateur comme modification non enregistrée. Dès que des heures ouvrées sont définies, les jours non cochés sont comptabilisés comme hors des heures ouvrées pour les appels utilisant ce planning.

Configurer les rapports via l’API

Les propriétaires et les administrateurs peuvent utiliser PATCH /v1/orgs/{id}/ avec timezone, business_hours et excluded_numbers :

timezone : un nom de fuseau horaire IANA tel que America/Los_Angeles, de 64 caractères maximum.
business_hours : des clés de jour de la semaine de mon à sun, chacune étant une liste d'au maximum quatre créneaux {start, end} au format 24 heures HH:MM, chaque heure de fin devant être postérieure à son heure de début. {} signifie qu'il n'y a pas de répartition entre heures ouvrées et hors des heures ouvrées.
excluded_numbers : jusqu'à 50 numéros de téléphone, stockés au format E.164. Un numéro nord-américain de 10 chiffres sans indicatif reçoit le code pays +1.

curl -X PATCH https://api.thunderphone.com/v1/orgs/42/ \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "America/Los_Angeles",
    "business_hours": {
      "mon": [{"start": "09:00", "end": "17:00"}],
      "sat": [{"start": "10:00", "end": "14:00"}]
    },
    "excluded_numbers": ["+14155550199"]
  }'

Appelants bloqués

Les numéros de cette liste ne peuvent pas joindre vos agents. Lorsqu'un numéro bloqué appelle l'un des numéros de téléphone de votre organisation, ThunderPhone raccroche avant qu'un agent ne réponde et ne facture pas l'appel. Il apparaît tout de même dans l'Historique des appels comme appel entrant échoué avec le motif de fin Appelant bloqué. Les appels dont l'identifiant de l'appelant est masqué ou anonyme ne sont jamais mis en correspondance, et les appels sortants vers un numéro bloqué ne sont pas affectés. Un appelant que vous bloquez pendant un appel n'est pas coupé ; le blocage s'applique à partir de son appel suivant.

Tous les membres peuvent voir la liste ; les propriétaires et les administrateurs la modifient sous Général → Appelants bloqués :

Pour bloquer un numéro, saisissez-le avec une note facultative et choisissez Bloquer le numéro. Utilisez + et le code pays ; un format national tel que (415) 555-0123 fonctionne également lorsque tous les numéros de téléphone de votre organisation se trouvent dans un même pays.
Pour bloquer plusieurs numéros à la fois, choisissez Coller une liste, collez jusqu'à 500 numéros (un par ligne ou séparés par des virgules), puis envoyez-la. Le résultat indique combien ont été ajoutés, étaient déjà bloqués ou étaient non valides, et répertorie les entrées non valides.
Pour débloquer un numéro, choisissez Supprimer sur sa ligne et confirmez.

Vous pouvez également ouvrir un appel entrant dans l'Historique des appels et choisir Bloquer cet appelant. Une organisation peut bloquer jusqu'à 10 000 numéros. Pour gérer la liste via l'API, consultez Appelants bloqués.

Identité et adhésion à l'organisation

La carte de l'organisation affiche l'identifiant de l'organisation, votre rôle de membre et le nom modifiable de l'organisation. La carte d'équipe regroupe les membres actifs et les invitations en attente.

Rôle	Accès typique
Membre	Créer et exploiter des agents, et examiner les appels.
Administrateur	Accès membre, plus l'administration de l'équipe, des clés, des portails, des connexions, des alertes, de la facturation et de la sécurité.
Propriétaire	Accès administrateur, plus les actions d'organisation au niveau du propriétaire.

Les propriétaires et administrateurs peuvent inviter un Membre ou un Administrateur, révoquer une invitation en attente, modifier les rôles des membres éligibles et supprimer des membres. Les invitations sont associées à une adresse e-mail et expirent après sept jours. Consultez Inviter votre équipe.

La zone de danger permet à un utilisateur éligible de quitter une organisation ou de la supprimer définitivement. La suppression retire les agents, les numéros, l'historique des appels et les données de facturation de l'organisation, et ne peut pas être annulée.

Pour supprimer votre propre compte, ouvrez l’onglet Compte et choisissez Supprimer le compte. La boîte de dialogue répertorie les organisations qui seront supprimées (celles où vous êtes le seul membre) et celles que vous quitterez. Les clés API que vous avez créées dans une organisation que vous quittez sont révoquées. La suppression est bloquée tant que vous êtes le seul propriétaire d’une organisation qui compte d’autres membres (désignez d’abord quelqu’un d’autre comme propriétaire), tant que vous avez créé des voix personnalisées dans une organisation qui reste, tant qu’un appel est en cours ou qu’une conservation légale s’applique ; la boîte de dialogue indique ce qui la bloque. Cette action est irréversible.

Webhook par défaut

Définissez une URL de webhook héritée pour recevoir les événements de tous les widgets web et numéros de téléphone de l'organisation. Pour les secrets par point de terminaison, les abonnements, l'historique de livraison et les nouvelles tentatives, utilisez plutôt les points de terminaison webhook recommandés.

SSO d'entreprise

Configurez une ou plusieurs connexions SSO, les domaines d'e-mail autorisés, le provisionnement juste-à-temps, le rôle par défaut et les mappages facultatifs de groupes vers des rôles. La politique de sécurité peut exiger le SSO, autoriser un accès d'urgence par mot de passe pour les administrateurs, et exiger des clés d'accès pour l'accès à l'organisation. Consultez SSO.

Clés

L'onglet Clés gère les clés API serveur secrètes sk_live_. Chaque ligne affiche le nom, le préfixe, l'état actif/révoqué, l'heure de création, la dernière utilisation et l'heure de révocation.

Le secret complet n'est affiché qu'une seule fois, immédiatement après sa création. Copiez-le à ce moment-là et stockez-le dans un gestionnaire de secrets. La révocation est définitive et arrête toute intégration utilisant la clé. Consultez Clés API.

Les clés publiables pk_live_ appartiennent aux Widgets web, car il s'agit d'identifiants de navigateur restreints à l'origine plutôt que de clés serveur.

Alertes

Créez des règles de métriques pour le taux de réussite, le taux d'échec, le score moyen, le volume d'appels ou les régressions de suite. Une règle comprend :

Un comparateur et un seuil numérique.
Une fenêtre d'évaluation de 1 à 720 heures.
Jusqu'à 10 destinataires d'e-mails.
Une URL facultative de webhook entrant Slack.
Une livraison facultative via webhook développeur.
Un délai de récupération en minutes entières et un état activé.

Le même onglet répertorie les déclenchements récents. Consultez Alertes.

Paramètres de facturation

Gérez le solde et le comportement de paiement de l'organisation :

Ajouter ou remplacer la carte de paiement par défaut.
Ajouter des fonds manuellement.
Activer le rechargement automatique et définir son seuil et son montant de recharge.
Définir ou supprimer une limite mensuelle de dépenses.

La limite mensuelle suspend les nouveaux appels et l'utilisation à 100 % et reste active même lorsque le rechargement automatique est désactivé. Consultez Tarification et Facturation et rechargements.

Historique de facturation

Utilisez Historique de facturation pour consulter le solde et les dépenses d'aujourd'hui, des 7 derniers jours, des 30 derniers jours, des 90 derniers jours ou depuis le début. Il comprend :

L'évolution du solde.
La répartition de la facturation entre les frais d'appel, les rapports, les frais de numéros de téléphone et les recharges.
Les agents les plus coûteux.
Un tableau des transactions avec la date, la catégorie, la description, le type, le montant et le solde résultant.
Le filtrage par catégorie et l'export CSV ou JSON de l'historique affiché.

Le tableau de bord indique lorsque seules les transactions les plus récentes sont affichées ; les lignes plus anciennes au-delà de cette limite sont également absentes de l'export. L' API de facturation prend en charge la pagination programmatique.