Verwenden Sie HTTPS und HTTP-Basic-Authentifizierung mit genehmigten API-Zugangsdaten. Bewahren Sie die Zugangsdaten auf Ihrem Anwendungsserver auf. Diese Hosted-PBX-Endpunkte verwenden /hpbx/ auf api.multitel.net; fügen Sie nicht /v3 ein. Prüfen Sie sowohl das HTTP-Ergebnis als auch den Anwendungsstatus in der JSON-Antwort.
Nummer und PBX auswählen
Die Struktur des Endpunkts lautet POST /hpbx/dids/{operation}/{billing_code}. Unterstützte Vorgänge sind Erstellen, Bearbeiten und Löschen. Der Abrechnungscode muss eine PBX identifizieren, die zum authentifizierten Konto gehört. Durch das Anlegen eines Routing-Eintrags wird keine neue öffentliche Telefonnummer gekauft.
Routing-Felder
| Feld | Zweck |
|---|---|
| number / fullnumber | Die DID, die durch den PBX-Routingdatensatz dargestellt wird. |
| comment | Eine an Administratoren gerichtete Beschreibung. |
| maxchannels | Die maximale Anzahl gleichzeitiger Anrufe der PBX-Route. |
| destination | Geordnete Zielwerte für die ausgewählte PBX. |
| unconditional | Ein bedingungsloses Weiterleitungsziel, sofern verwendet. |
| cnam | Einstellung für die Anrufernamen-Abfrage; Nutzungsgebühren können anfallen. |
| recording | Aufzeichnungsrichtlinie: no, yes, yeschange oder nochange. |
| di_emailrecording / di_minemailrecording | Ziel-E-Mail-Adresse der Aufzeichnung und Mindestdauer. |
| allowemergency / emergencynotes | Einstellungen für die Notruf-Anrufer-ID; diese registrieren keine Notrufadresse. |
| didprefix / didnameprefix | Anrufernummern-/Anrufernamen-Präfixe. |
| fax / faxprotocol / faxstore / faxemail | Faxerkennung, Protokoll sowie Optionen für Zustellung und Speicherung. |
| sms_destination / di_smstofield / di_sms_store | Aktivierte Einstellungen für Nachrichtenzustellung/-speicherung. |
Gültige Ziele vorbereiten
Zielwerte müssen aus der ausgewählten PBX stammen; das frühere Array()-Beispiel war keine JSON- oder Formular-Payload. Lösen Sie Nebenstellen, IVRs oder Gruppen auf, bevor Sie die Anfrage erstellen. Verwenden Sie das aktuelle Nummernrouting-Schema für die API-Schnittstelle, mit der Sie Ihre Anwendung integrieren.
Das Ergebnis überprüfen
Prüfen Sie den in der API-Antwort gemeldeten Status des Vorgangs, öffnen Sie die Konfiguration der Nummer erneut und führen Sie einen kontrollierten eingehenden Anruf durch. Prüfen Sie die Pfade für Besetzt, Keine Antwort, Timeout sowie Aufzeichnung/Fax/Nachricht jeweils getrennt. Folgen Sie der Routing-Anleitung im Portal für eine schrittweise Konfiguration.