API REST Teloz

Zbuduj głos w dowolnym miejscu za pomocą API Teloza

Inicjuj połączenia, odbieraj webhooki, przesyłaj strumieniowo transkrypcje i osadzaj w pełni funkcjonalny dialer — a wszystko to za pośrednictwem przejrzystego interfejsu API REST z pakietami SDK dla każdego głównego języka.

API RESTOWEHaki internetoweSpecyfikacja OpenAPISDKCzas sprawności na poziomie 99,99%.
200 OK — połączenie w kolejce
Dołączona specyfikacja OpenAPI 3.0
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
// }
Według liczb

Zbudowany do produkcji od pierwszego dnia

Teloz API to ta sama infrastruktura, z której korzystają tysiące użytkowników w USA biznesowe systemy telefoniczne codziennie.

99.99%
Umowa SLA dotycząca dostępności interfejsu API
Niezawodność klasy korporacyjnej
< 100 ms
Średni czas reakcji
We wszystkich regionach USA
50+
Punkty końcowe REST
Połączenia, kontakty, numery i nie tylko
4 zestawy SDK
Oficjalne biblioteki językowe
Węzeł, Python, PHP, Go
Punkty końcowe

Sześć grup zasobów, ponad 50 punktów końcowych

Wszystko, czego potrzebujesz, aby włączyć w swoim produkcie funkcje połączeń głosowych, SMS-ów i centrum kontaktowego.

WYŚLIJ · POBIERZ · USUŃ

Połączenia

Inicjuj połączenia wychodzące, pobieraj zapisy rozmów, uzyskuj dostęp do nagrań i przesyłaj strumieniowo transkrypcje w czasie rzeczywistym.

POST/v1/calls
DOSTAWAĆ/v1/calls/:sid
DOSTAWAĆ/v1/calls/:sid/recording
USUWAĆ/v1/calls/:sid
WYŚLIJ · POBIERZ · WSTAW · USUŃ

Łączność

Twórz, czytaj, aktualizuj i usuwaj kontakty. Synchronizuj z CRM lub stwórz własną książkę telefoniczną.

POST/v1/contacts
DOSTAWAĆ/v1/contacts
UMIEŚCIĆ/v1/contacts/:id
USUWAĆ/v1/contacts/:id
WYŚLIJ · POBIERZ · USUŃ

Takty muzyczne

Wyszukuj dostępne numery, udostępniaj lokalne lub bezpłatne identyfikatory DID i zarządzaj konfiguracją numerów.

DOSTAWAĆ/v1/numbers/available
POST/v1/numbers
DOSTAWAĆ/v1/numbers/:id
USUWAĆ/v1/numbers/:id
WYŚLIJ · POBIERZ · USUŃ

Haki internetowe

Zarejestruj punkty końcowe, aby otrzymywać w czasie rzeczywistym zdarzenia dotyczące połączeń, wiadomości głosowych, transkrypcji i SMS-ów.

POST/v1/webhooks
DOSTAWAĆ/v1/webhooks
UMIEŚCIĆ/v1/webhooks/:id
USUWAĆ/v1/webhooks/:id
DOSTAWAĆ

Analityka

Pobieraj statystyki dotyczące głośności, czasu trwania, dyspozycji i kolejek połączeń dla swoich pulpitów nawigacyjnych i raportów.

DOSTAWAĆ/v1/analytics/calls
DOSTAWAĆ/v1/analytics/queues
DOSTAWAĆ/v1/analytics/agents
DOSTAWAĆ/v1/analytics/summary
SDK JavaScriptu

Wbudowany dialer

Umieść w pełni funkcjonalny widget typu „kliknij, aby połączyć” w dowolnej aplikacji internetowej za pomocą kilku linijek kodu JavaScript.

teloz.dialer.init(config)
teloz.dialer.call(number)
teloz.dialer.on('event', fn)
teloz.dialer.destroy()
Przykłady kodu

Zintegruj się z wybranym przez Ciebie językiem

Oficjalne zestawy SDK dla Node.js, Python, PHP i Go — lub zadzwoń pod numer API RESTOWE bezpośrednio z dowolnego języka.

Zainicjuj połączenie
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…
Haki internetowe

Reaguj na każde zdarzenie wywoławcze czasie rzeczywistym

Zarejestruj adres URL webhooka, a Teloz wyśle ​​podpisany ładunek JSON do Twojego punktu końcowego w momencie wystąpienia zdarzenia — nie jest wymagane odpytywanie. Połącz webhook z naszym integracje aby zautomatyzować przepływ pracy od początku do końca.

Podpis HMAC-SHA256 na każdym ładunku
Automatyczna ponowna próba z wykładniczym wycofywaniem
Dzienniki dostaw i powtórki na pulpicie nawigacyjnym
Możliwość filtrowania według typu zdarzenia dla każdego punktu końcowego
WydarzenieKategoria
call.initiatedUruchamiane, gdy połączenie wychodzące znajduje się w kolejce
Połączenia
call.ringingTelefon docelowy dzwoni
Połączenia
call.answeredPołączenie zostało odebrane — zawiera metadane dzwoniącego
Połączenia
call.completedPołączenie zakończone — obejmuje czas trwania i dyspozycję
Połączenia
call.missedPołączenie przychodzące pozostało bez odpowiedzi
Połączenia
recording.readyAdres URL pliku nagrania jest dostępny do pobrania
Nagranie
transcript.readyW załączeniu pełny tekst transkrypcji i etykiety prelegentów
sztuczna inteligencja
voicemail.newOtrzymano nową pocztę głosową z adresem URL dźwięku
Poczta głosowa
sms.inboundPrzychodzące SMS-y odebrane na udostępniony numer
SMS-em
Często zadawane pytania dotyczące API

Krótkie odpowiedzi.

Często zadawane pytania przed rozpoczęciem budowy.

Zarejestruj konto Teloz i przejdź do Ustawienia → Programista → Klucze API. Możesz utworzyć wiele kluczy z ograniczonymi uprawnieniami (tylko do odczytu, tylko do połączeń, administrator) i unieważnić je w dowolnym momencie.

Tak. Pełna specyfikacja OpenAPI 3.0 jest dostępna pod adresem api.teloz.com/openapi.json i można ją zaimportować bezpośrednio do Postman, Insomnia lub dowolnego kompatybilnego klienta. Jest synchronizowany z każdym wydaniem.

Interfejs API korzysta z uwierzytelniania tokenu okaziciela. Przekaż swój klucz API w nagłówku autoryzacji jako „Nosiciel YOUR_API_KEY”. Do użytku serwer-serwer zalecamy klucze o określonym zakresie; w przypadku dialerów wbudowanych w przeglądarkę należy używać krótkotrwałych tokenów OAuth.

Tak — domyślny limit to 100 żądań na sekundę na klucz API. Dozwolone są serie do 500 żądań/s przez maksymalnie 10 sekund. Plany Enterprise mogą wymagać wyższych limitów. Nagłówki limitów szybkości (X-RateLimit-Remaining, X-RateLimit-Reset) są zwracane w każdej odpowiedzi.

Każdy wpis POST webhooka zawiera nagłówek X-Teloz-Signature zawierający skrót HMAC-SHA256 nieprzetworzonej treści żądania podpisany tajemnicą webhooka. Oblicz ten sam skrót po swojej stronie i porównaj — odrzucaj żądania, które nie pasują.

Tak. Użyj podstawowego adresu URL https://api.sandbox.teloz.com z testowym kluczem API. Połączenia wykonywane w trybie piaskownicy nigdy nie są łączone z siecią PSTN — symulują pełny cykl życia wydarzenia, w tym nagrania i transkrypcje.

Rozpocznij budowanie z API Teloz. W zestawie darmowa piaskownica.

Zdobądź klucz API w niecałe dwie minuty. Przed uruchomieniem przetestuj naszą w pełni funkcjonalną piaskownicę — nie jest wymagana karta kredytowa.

Pełna specyfikacja OpenAPI4 oficjalne SDKŚrodowisko piaskownicyWsparcie programistów z USA