Construire avec les API TELQIO

Commencez par un premier appel simulé, puis branchez vos webhooks.

Passer un premier appel par API Demander un accès développeur

Pensé pour les développeurs

API documentée

Idempotence sur les écritures, pagination par curseur, erreurs explicites.

Webhooks signés

Horodatage, tolérance d’horloge et identifiant d’événement à dédupliquer.

Scénarios

Éditeur visuel et version texte, simulation, publication et retour arrière.

Diagnostics

Une explication lisible, et le détail technique si besoin.

Exemple fictif · simulation, aucun appel réel

curl -X POST https://api.example.test/v1/calls \
  -H "Authorization: Bearer tq_test_EXEMPLE" \
  -H "Idempotency-Key: 7f1c2e0a-4b6d-4c1f-9a11-2f3b5d6e7a80" \
  -H "Content-Type: application/json" \
  -d '{"from":"+33199001000","to":"+33199001234","project_id":"prj_support"}'

{ "id": "cal_example", "status": "ringing", "simulated": true }

Guides d’intégration

Passer un premier appel par API

Ce guide montre comment déclencher un appel sortant avec l’API voix de démonstration, puis suivre son état. Tout est fictif : l’appel est une simulation tant qu’aucun fournisseur n’est configuré.

Envoyer un premier SMS par API

Ce guide montre l’envoi d’un SMS avec l’API de démonstration, la lecture des segments et de l’encodage, puis le suivi des statuts. Le SMS est simulé tant qu’aucun fournisseur n’est configuré.

Gérer ses numéros par API

Ce guide couvre trois gestes : chercher un numéro disponible, le commander pour un projet, puis lister votre parc. La commande est simulée tant qu’aucun fournisseur n’est configuré.

Lire ses consommations

Ce guide montre comment lire les quantités consommées par jour, numéro, projet, pays ou service. Les chiffres de l’exemple sont fictifs et ne portent aucun montant.

Ce guide explique comment authentifier un événement reçu par webhook : lecture de l’en-tête, calcul de la signature, comparaison à temps constant, contrôle de la tolérance et déduplication. Exemple en Node.js, fictif.

Préparer une portabilité

Ce guide est une liste de préparation, pas une procédure officielle. Il vous aide à rassembler ce qu’il faut avant de décrire votre besoin dans une demande de devis.