API REST Teloz

Intégrez la voix à n'importe quoi avec le API Teloz

Lancez des appels, recevez des webhooks, diffusez des transcriptions et intégrez un numéroteur complet, le tout via une API REST propre avec des SDK pour chaque langue principale.

API RESTWebhooksSpécification OpenAPISDK99,99 % de disponibilité
200 OK — appel en file d'attente
Spécification OpenAPI 3.0 incluse
teloz-api.js
// Initiate an outbound call
 
const response = await teloz.calls.create({
to: "+12025550123",
from: "+18005550199",
record: true,
webhook: "https://your-app.com/events"
});
 
// Response
// {
// sid: "CA3f9a…"
// status: "queued"
// duration: null
// }
En chiffres

Conçu pour la production dès le premier jour

L'API Teloz est la même infrastructure qui alimente des milliers d'utilisateurs aux États-Unis. systèmes téléphoniques professionnels tous les jours.

99.99%
SLA de disponibilité de l'API
Fiabilité de niveau entreprise
< 100 ms
Temps de réponse médian
Dans toutes les régions des États-Unis
50+
Points de terminaison REST
Appels, contacts, numéros et plus
4 SDK
Bibliothèques de langues officielles
Noeud, Python, PHP, Go
Points de terminaison

Six groupes de ressources, plus de 50 points de terminaison

Tout ce dont vous avez besoin pour intégrer des fonctionnalités de voix, de SMS et de centre de contact dans votre produit.

PUBLIER · OBTENIR · SUPPRIMER

Appels

Lancez des appels sortants, récupérez des enregistrements d'appels, accédez aux enregistrements et diffusez des transcriptions en temps réel.

POSTE/v1/calls
OBTENIR/v1/calls/:sid
OBTENIR/v1/calls/:sid/recording
SUPPRIMER/v1/calls/:sid
PUBLIER · OBTENIR · METTRE · SUPPRIMER

Contacts

Créez, lisez, mettez à jour et supprimez des contacts. Synchronisez avec votre CRM ou créez votre propre répertoire téléphonique.

POSTE/v1/contacts
OBTENIR/v1/contacts
METTRE/v1/contacts/:id
SUPPRIMER/v1/contacts/:id
PUBLIER · OBTENIR · SUPPRIMER

Nombres

Recherchez les numéros disponibles, fournissez des DID locaux ou gratuits et gérez la configuration des numéros.

OBTENIR/v1/numbers/available
POSTE/v1/numbers
OBTENIR/v1/numbers/:id
SUPPRIMER/v1/numbers/:id
PUBLIER · OBTENIR · SUPPRIMER

Webhooks

Enregistrez les points de terminaison pour recevoir des événements en temps réel concernant les appels, les messages vocaux, les transcriptions et les SMS.

POSTE/v1/webhooks
OBTENIR/v1/webhooks
METTRE/v1/webhooks/:id
SUPPRIMER/v1/webhooks/:id
OBTENIR

Analytique

Extrayez les statistiques sur le volume, la durée, la disposition et la file d'attente des appels pour vos tableaux de bord et rapports.

OBTENIR/v1/analytics/calls
OBTENIR/v1/analytics/queues
OBTENIR/v1/analytics/agents
OBTENIR/v1/analytics/summary
SDK JavaScript

Numéroteur intégré

Déposez un widget Cliquer pour appeler complet dans n'importe quelle application Web avec quelques lignes de JavaScript.

teloz.dialer.init(config)
teloz.dialer.call(number)
teloz.dialer.on('event', fn)
teloz.dialer.destroy()
Exemples de codes

Intégrez dans la langue de votre choix

SDK officiels pour Node.js, Python, PHP et Go – ou appelez le API REST directement depuis n’importe quelle langue.

Lancer un appel
import Teloz from "@teloz/node";
 
const client = new Teloz(process.env.TELOZ_API_KEY);
 
const call = await client.calls.create({
to: "+12025550123",
from: "+18005550199",
record: true,
transcribe: true,
webhook: "https://your-app.com/events",
});
 
console.log(call.sid); // CA3f9a7b…
Webhooks

Réagissez à chaque événement d'appel dans temps réel

Enregistrez une URL de webhook et Teloz POSTera une charge utile JSON signée sur votre point de terminaison dès qu'un événement se produit – aucune interrogation n'est requise. Combinez les webhooks avec notre intégrations pour automatiser vos flux de travail de bout en bout.

Signature HMAC-SHA256 sur chaque charge utile
Nouvelle tentative automatique avec interruption exponentielle
Journaux de livraison & replay dans le tableau de bord
Filtrable par type d'événement par point de terminaison
ÉvénementCatégorie
call.initiatedDéclenché lorsqu'un appel sortant est mis en file d'attente
Appels
call.ringingLe téléphone de destination sonne
Appels
call.answeredL'appel a été pris – inclut les métadonnées de l'appelant
Appels
call.completedAppel terminé – inclut la durée et la disposition
Appels
call.missedL'appel entrant est resté sans réponse
Appels
recording.readyL'URL du fichier d'enregistrement est disponible en téléchargement
Enregistrement
transcript.readyTexte complet de la transcription et étiquettes des intervenants ci-jointes
IA
voicemail.newNouveau message vocal reçu avec l'URL audio
Messagerie vocale
sms.inboundSMS entrant reçu sur un numéro provisionné
SMS
FAQ sur les API

Les réponses courtes.

Questions courantes avant de commencer à construire.

Créez un compte Teloz et accédez à Paramètres → Développeur → Clés API. Vous pouvez créer plusieurs clés avec des autorisations étendues (lecture seule, appels uniquement, administrateur) et les révoquer à tout moment.

Oui. La spécification OpenAPI 3.0 complète est disponible sur api.teloz.com/openapi.json et peut être importée directement dans Postman, Insomnia ou tout autre client compatible. Il est synchronisé avec chaque version.

L'API utilise l'authentification par jeton Bearer. Transmettez votre clé API dans l'en-tête d'autorisation en tant que « Bearer YOUR_API_KEY ». Pour une utilisation de serveur à serveur, nous recommandons les clés étendues ; pour les numéroteurs intégrés au navigateur, utilisez des jetons OAuth de courte durée.

Oui : la limite par défaut est de 100 requêtes par seconde et par clé API. Des rafales allant jusqu'à 500 req/s sont autorisées pendant 10 secondes maximum. Les forfaits Entreprise peuvent demander des limites plus élevées. Les en-têtes de limite de débit (X-RateLimit-Remaining, X-RateLimit-Reset) sont renvoyés à chaque réponse.

Chaque webhook POST comprend un en-tête X-Teloz-Signature contenant un hachage HMAC-SHA256 du corps brut de la requête signé avec votre secret de webhook. Calculez le même hachage de votre côté et comparez – rejetez les demandes qui ne correspondent pas.

Oui. Utilisez l'URL de base https://api.sandbox.teloz.com avec votre clé API de test. Les appels passés en mode sandbox ne sont jamais connectés au PSTN : ils simulent le cycle de vie complet de l'événement, y compris les enregistrements et les transcriptions.

Commencez à créer avec l'API Teloz. Bac à sable gratuit inclus.

Obtenez votre clé API en moins de deux minutes. Testez avec notre bac à sable complet avant de mettre en ligne – aucune carte de crédit requise.

Spécification OpenAPI complète4 SDK officielsEnvironnement bac à sableAssistance aux développeurs américains