Vonage (Vorschau)
Mit der Vonage-API-Plattform können Sie kommunikationen im Kontext Ihrer Anwendungen hinzufügen, einschließlich SMS, Voice und Chat. Registrieren Sie sich hier für ein Nexmo-Konto - https://www.vonage.com/
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Vonage-Unterstützung |
| URL | https://www.vonage.co.uk/support |
| support@vonage.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Vonage |
| Webseite | https://vonage.com |
| Datenschutzrichtlinie | https://www.vonage.com/legal/privacy-policy |
| Kategorien | Communication |
Mit der Vonage-API-Plattform können Sie kommunikationen im Kontext Ihrer Anwendungen hinzufügen, einschließlich SMS, Voice und Chat.
Voraussetzungen
Sie benötigen Folgendes, um fortzufahren:
- Ein Vonage-Konto, registrieren Sie sich bei https://dashboard.nexmo.com/sign-up
So erhalten Sie Anmeldeinformationen
Um Anmeldeinformationen zu erhalten, können Sie sich für ein kostenloses Vonage-Konto anmelden unter https://dashboard.nexmo.com/sign-up
Bekannte Probleme und Einschränkungen
Dieser Connector macht derzeit nicht alle Vonage-Produkte und APIs verfügbar.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Anfordern einer Überprüfung |
Verwenden der Verify-Anforderung zum Generieren und Senden einer PIN an Ihren Benutzer |
| Senden einer Nachricht an den angegebenen Kanal |
Senden einer Nachricht |
| Stellt grundlegende Einblicke in Zahlen zu einer Zahl bereit. |
Stellt grundlegende Einblicke in Zahlen zu einer Zahl bereit. |
| Stellt Standardnummern-Einblicksinformationen zu einer Zahl bereit. |
Stellt Standardnummern-Einblicksinformationen zu einer Zahl bereit. |
| Überprüfen der Überprüfung |
Bestätigt die PIN, die Sie von Ihrem Benutzer erhalten haben, mit der Anforderung "Überprüfen" |
Anfordern einer Überprüfung
Verwenden der Verify-Anforderung zum Generieren und Senden einer PIN an Ihren Benutzer
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Das Antwortformat
|
format | True | string |
Das Antwortformat |
|
Sie finden Ihren API-Schlüssel im Kontodashboard. https://dashboard.nexmo.com
|
api_key | True | string |
Sie finden Ihren API-Schlüssel im Kontodashboard. https://dashboard.nexmo.com |
|
Sie finden Ihren API-Geheimschlüssel im Dashboard. https://dashboard.nexmo.com
|
api_secret | True | string |
Sie finden Ihren API-Geheimschlüssel im Dashboard. https://dashboard.nexmo.com |
|
Die zu überprüfende Mobiltelefon- oder Festnetztelefonnummer. Die Zahl muss im E.164-Format vorliegen.
|
number | True | string |
Die zu überprüfende Mobiltelefon- oder Festnetztelefonnummer. Die Zahl muss im E.164-Format vorliegen. |
|
Geben Sie den Zwei-Zeichen-Ländercode an, und überprüfen Sie dann, ob die Zahl formatiert wird.
|
country | string |
Geben Sie den Zwei-Zeichen-Ländercode an, und überprüfen Sie dann, ob die Zahl formatiert wird. |
|
|
Eine 18-stellige alphanumerische Zeichenfolge, die zum Personalisieren des Anforderungs-SMS-Texts verwendet wird
|
brand | True | string |
Eine 18-stellige alphanumerische Zeichenfolge, die zum Personalisieren des Anforderungs-SMS-Texts verwendet wird |
|
Eine 11-stellige alphanumerische Zeichenfolge, die die Identität des Absenders darstellt
|
sender_id | string |
Eine 11-stellige alphanumerische Zeichenfolge, die die Identität des Absenders darstellt |
|
|
Die Länge des Überprüfungscodes
|
code_length | integer |
Die Länge des Überprüfungscodes |
|
|
Steuern der sprache, die für die Verify-Anforderung verwendet wird
|
lg | string |
Steuern der sprache, die für die Verify-Anforderung verwendet wird |
|
|
Wie lange der generierte Überprüfungscode gültig ist, in Sekunden
|
pin_expiry | integer |
Wie lange der generierte Überprüfungscode gültig ist, in Sekunden |
|
|
Wartezeit in Sekunden zwischen versuchen, den Überprüfungscode zu übermitteln
|
next_event_wait | integer |
Wartezeit in Sekunden zwischen versuchen, den Überprüfungscode zu übermitteln |
|
|
Vordefinierte Abfolge von SMS- und TTS-Aktionen, um die PIN an Ihren Benutzer zu übermitteln
|
workflow_id | integer |
Vordefinierte Abfolge von SMS- und TTS-Aktionen, um die PIN an Ihren Benutzer zu übermitteln |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
status
|
status | string | |
|
Anfrage_ID
|
request_id | string |
Senden einer Nachricht an den angegebenen Kanal
Senden einer Nachricht
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Inhaltstyp für Anforderung
|
Content-Type | True | string |
Inhaltstyp |
|
Akzeptierter Datumstyp
|
Accept | True | string |
Akzeptieren |
|
Der Typ der zu sendenden Nachricht. Sie müssen Text in diesem Feld angeben.
|
message_type | string |
Der Typ der zu sendenden Nachricht. Sie müssen Text in diesem Feld angeben. |
|
|
Der zu sendende Text der Nachricht; auf 1000 Zeichen beschränkt
|
text | string |
Der zu sendende Text der Nachricht; auf 1000 Zeichen beschränkt |
|
|
Die Telefonnummer des Nachrichtenempfängers im E.164-Format
|
to | string |
Die Telefonnummer des Nachrichtenempfängers im E.164-Format |
|
|
Die Telefonnummer des Nachrichtenempfängers im E.164-Format
|
from | string |
Die Telefonnummer des Nachrichtenempfängers im E.164-Format |
|
|
Der Kanal, an den gesendet werden soll. Sie müssen sms in diesem Feld angeben.
|
channel | string |
Der Kanal, an den gesendet werden soll. Sie müssen sms in diesem Feld angeben. |
|
|
Clientverweis von bis zu 40 Zeichen
|
client_ref | string |
Clientverweis von bis zu 40 Zeichen |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
message_uuid
|
message_uuid | string |
message_uuid |
Stellt grundlegende Einblicke in Zahlen zu einer Zahl bereit.
Stellt grundlegende Einblicke in Zahlen zu einer Zahl bereit.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Das Antwortformat
|
format | True | string |
Das Antwortformat |
|
Ihr API-Schlüssel
|
api_key | True | string |
Ihr API-Schlüssel |
|
Ihr API-Geheimnis
|
api_secret | True | string |
Ihr API-Geheimnis |
|
Eine Telefonnummer, über die Sie Einblick in nationales oder internationales Format benötigen
|
number | True | string |
Eine Telefonnummer, über die Sie Einblick in nationales oder internationales Format benötigen |
|
Zweistellige Ländercode im ISO 3166-1 Alpha-2-Format z. B. GB oder US
|
country | True | string |
Zweistellige Ländercode im ISO 3166-1 Alpha-2-Format z. B. GB oder US |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
status
|
status | integer | |
|
status_message
|
status_message | string | |
|
Anfrage_ID
|
request_id | string | |
|
international_format_number
|
international_format_number | string | |
|
national_format_number
|
national_format_number | string | |
|
country_code
|
country_code | string | |
|
country_code_iso3
|
country_code_iso3 | string | |
|
country_name
|
country_name | string | |
|
country_prefix
|
country_prefix | string |
Stellt Standardnummern-Einblicksinformationen zu einer Zahl bereit.
Stellt Standardnummern-Einblicksinformationen zu einer Zahl bereit.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Das Antwortformat
|
format | True | string |
Das Antwortformat |
|
Ihr API-Schlüssel
|
api_key | True | string |
Ihr API-Schlüssel |
|
Ihr API-Geheimnis
|
api_secret | True | string |
Ihr API-Geheimnis |
|
Eine Telefonnummer, über die Sie Einblick in nationales oder internationales Format benötigen
|
number | True | string |
Eine Telefonnummer, über die Sie Einblick in nationales oder internationales Format benötigen |
|
Zweistellige Ländercode im ISO 3166-1 Alpha-2-Format z. B. GB oder US
|
country | True | string |
Zweistellige Ländercode im ISO 3166-1 Alpha-2-Format z. B. GB oder US |
|
Auf "true" festlegen, um den Besitzernamen der Telefonnummer in der Antwort zu empfangen
|
cnam | string |
Auf "true" festlegen, um den Besitzernamen der Telefonnummer in der Antwort zu empfangen |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
status
|
status | integer | |
|
status_message
|
status_message | string | |
|
Anfrage_ID
|
request_id | string | |
|
international_format_number
|
international_format_number | string | |
|
national_format_number
|
national_format_number | string | |
|
country_code
|
country_code | string | |
|
country_code_iso3
|
country_code_iso3 | string | |
|
country_name
|
country_name | string | |
|
country_prefix
|
country_prefix | string | |
|
request_price
|
request_price | string | |
|
refund_price
|
refund_price | string | |
|
remaining_balance
|
remaining_balance | string | |
|
network_code
|
current_carrier.network_code | string | |
|
name
|
current_carrier.name | string | |
|
country
|
current_carrier.country | string | |
|
network_type
|
current_carrier.network_type | string | |
|
network_code
|
original_carrier.network_code | string | |
|
name
|
original_carrier.name | string | |
|
country
|
original_carrier.country | string | |
|
network_type
|
original_carrier.network_type | string | |
|
portiert
|
ported | string | |
|
caller_type
|
caller_identity.caller_type | string | |
|
caller_name
|
caller_identity.caller_name | string | |
|
first_name
|
caller_identity.first_name | string | |
|
last_name
|
caller_identity.last_name | string | |
|
caller_name
|
caller_name | string | |
|
last_name
|
last_name | string | |
|
first_name
|
first_name | string | |
|
caller_type
|
caller_type | string |
Überprüfen der Überprüfung
Bestätigt die PIN, die Sie von Ihrem Benutzer erhalten haben, mit der Anforderung "Überprüfen"
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Das Antwortformat
|
format | True | string |
Das Antwortformat |
|
Ihr API-Schlüssel
|
api_key | True | string |
Ihr API-Schlüssel |
|
Ihr API-Geheimer Schlüssel
|
api_secret | True | string |
Ihr API-Geheimer Schlüssel |
|
Dies ist die request_id, die Sie in der Antwort auf die Verify-Anforderung erhalten haben.
|
request_id | True | string |
Dies ist die request_id, die Sie in der Antwort auf die Verify-Anforderung erhalten haben. |
|
Der vom Benutzer eingegebene Überprüfungscode
|
code | True | string |
Der vom Benutzer eingegebene Überprüfungscode |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anfrage_ID
|
request_id | string | |
|
event_id
|
event_id | string | |
|
status
|
status | string | |
|
Preis
|
price | string | |
|
Währung
|
currency | string | |
|
estimated_price_messages_sent
|
estimated_price_messages_sent | string |