Użyj HTTPS i uwierzytelniania HTTP Basic z zatwierdzonymi poświadczeniami API. Przechowuj poświadczenia na serwerze aplikacji. Te punkty końcowe Hosted PBX używają /hpbx/ na api.multitel.net; nie wstawiaj /v3. Sprawdzaj zarówno wynik HTTP, jak i status aplikacji w odpowiedzi JSON.
Wybierz numer i centralę PBX
Format punktu końcowego (endpoint) to POST /hpbx/dids/{operation}/{billing_code}. Obsługiwane operacje obejmują tworzenie, edycję i usuwanie. Kod rozliczeniowy musi wskazywać centralę PBX należącą do uwierzytelnionego konta. Rekord routingu nie powoduje zakupu nowego publicznego numeru telefonu.
Pola routingu
| Pole | Cel |
|---|---|
| number / fullnumber | Numer DID reprezentowany przez rekord routingu PBX. |
| comment | Opis przeznaczony dla administratora. |
| maxchannels | Maksymalna liczba równoczesnych połączeń trasy PBX. |
| destination | Uporządkowane wartości miejsc docelowych dla wybranego PBX. |
| unconditional | Miejsce docelowe bezwarunkowego przekierowania, jeśli jest używane. |
| cnam | Ustawienie wyszukiwania nazwy dzwoniącego; mogą obowiązywać opłaty za użytkowanie. |
| recording | Zasady nagrywania: no, yes, yeschange lub nochange. |
| di_emailrecording / di_minemailrecording | Adres e-mail nagrań oraz minimalny czas trwania. |
| allowemergency / emergencynotes | Ustawienia identyfikatora rozmówcy dla połączeń alarmowych; nie rejestrują one adresu alarmowego. |
| didprefix / didnameprefix | Prefiksy numeru/nazwy dzwoniącego. |
| fax / faxprotocol / faxstore / faxemail | Wykrywanie faksu, wybór protokołu oraz sposobu dostarczania/przechowywania. |
| sms_destination / di_smstofield / di_sms_store | Włączone ustawienia dostarczania/przechowywania wiadomości. |
Przygotuj prawidłowe miejsca docelowe
Wartości miejsc docelowych muszą pochodzić z wybranego PBX; dawny przykład Array() nie zawierał danych w formacie JSON ani danych formularza. Przed zbudowaniem żądania ustal numery wewnętrzne, IVR-y lub grupy. Użyj aktualnego schematu routingu numerów dla interfejsu API, z którą się integrujesz.
Zweryfikuj wynik
Sprawdź status operacji zwrócony w odpowiedzi API, ponownie otwórz konfigurację numeru i wykonaj kontrolowane połączenie przychodzące. Sprawdź osobno ścieżki zajętości, braku odpowiedzi, przekroczenia limitu czasu oraz nagrywania/faksu/wiadomości. Skorzystaj z przewodnika po routingu w portalu, aby uzyskać konfigurację krok po kroku.