Vonage (anteprima)
La piattaforma API Vonage consente di aggiungere comunicazioni all'interno del contesto delle applicazioni, tra cui SMS, Voce e Chat. Iscriversi per ottenere un account Nexmo qui - https://www.vonage.com/
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Supporto vonage |
| URL | https://www.vonage.co.uk/support |
| support@vonage.com |
| Metadati del connettore | |
|---|---|
| Editore | Vonage |
| Sito web | https://vonage.com |
| Informativa sulla privacy | https://www.vonage.com/legal/privacy-policy |
| Categorie | Communication |
La piattaforma API Vonage consente di aggiungere comunicazioni all'interno del contesto delle applicazioni, tra cui SMS, Voce e Chat.
Prerequisiti
Per procedere, è necessario quanto segue:
- Un account Vonage, iscriversi all'indirizzo https://dashboard.nexmo.com/sign-up
Come ottenere le credenziali
Per ottenere le credenziali è possibile iscriversi per ottenere un account Vonage gratuito all'indirizzo https://dashboard.nexmo.com/sign-up
Problemi noti e limitazioni
Questo connettore attualmente non espone tutti i prodotti e le API Vonage
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Fornisce informazioni dettagliate sui numeri di base su un numero |
Fornisce informazioni dettagliate sui numeri di base su un numero |
| Fornisce informazioni dettagliate sui numeri standard su un numero |
Fornisce informazioni dettagliate sui numeri standard su un numero |
| Inviare un messaggio al canale specificato |
Inviare un messaggio |
| Richiedere una verifica |
Usare Verifica richiesta per generare e inviare un PIN all'utente |
| Verificare il controllo |
Conferma che il PIN ricevuto dall'utente corrisponde alla richiesta Verify |
Fornisce informazioni dettagliate sui numeri di base su un numero
Fornisce informazioni dettagliate sui numeri di base su un numero
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Formato della risposta
|
format | True | string |
Formato della risposta |
|
Chiave API
|
api_key | True | string |
Chiave API |
|
Segreto DELL'API
|
api_secret | True | string |
Segreto DELL'API |
|
Un numero di telefono che è necessario conoscere in formato nazionale o internazionale
|
number | True | string |
Un numero di telefono che è necessario conoscere in formato nazionale o internazionale |
|
Codice paese a due caratteri nel formato ISO 3166-1 alfa-2, ad esempio. GB o Stati Uniti
|
country | True | string |
Codice paese a due caratteri nel formato ISO 3166-1 alfa-2, ad esempio. GB o Stati Uniti |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
status
|
status | integer | |
|
status_message
|
status_message | string | |
|
ID richiesta
|
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 |
Fornisce informazioni dettagliate sui numeri standard su un numero
Fornisce informazioni dettagliate sui numeri standard su un numero
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Formato della risposta
|
format | True | string |
Formato della risposta |
|
Chiave API
|
api_key | True | string |
Chiave API |
|
Segreto DELL'API
|
api_secret | True | string |
Segreto DELL'API |
|
Un numero di telefono che è necessario conoscere in formato nazionale o internazionale
|
number | True | string |
Un numero di telefono che è necessario conoscere in formato nazionale o internazionale |
|
Codice paese a due caratteri nel formato ISO 3166-1 alfa-2, ad esempio. GB o Stati Uniti
|
country | True | string |
Codice paese a due caratteri nel formato ISO 3166-1 alfa-2, ad esempio. GB o Stati Uniti |
|
Impostare su true per ricevere il nome del proprietario del numero di telefono nella risposta
|
cnam | string |
Impostare su true per ricevere il nome del proprietario del numero di telefono nella risposta |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
status
|
status | integer | |
|
status_message
|
status_message | string | |
|
ID richiesta
|
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 | |
|
nome
|
current_carrier.name | string | |
|
country
|
current_carrier.country | string | |
|
network_type
|
current_carrier.network_type | string | |
|
network_code
|
original_carrier.network_code | string | |
|
nome
|
original_carrier.name | string | |
|
country
|
original_carrier.country | string | |
|
network_type
|
original_carrier.network_type | string | |
|
Portato
|
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 |
Inviare un messaggio al canale specificato
Inviare un messaggio
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Tipo di contenuto per la richiesta
|
Content-Type | True | string |
Content-Type |
|
Tipo di data accettato
|
Accept | True | string |
Accettare |
|
Tipo di messaggio da inviare. È necessario specificare il testo in questo campo
|
message_type | string |
Tipo di messaggio da inviare. È necessario specificare il testo in questo campo |
|
|
Testo del messaggio da inviare; limitato a 1000 caratteri
|
text | string |
Testo del messaggio da inviare; limitato a 1000 caratteri |
|
|
Numero di telefono del destinatario del messaggio nel formato E.164
|
to | string |
Numero di telefono del destinatario del messaggio nel formato E.164 |
|
|
Numero di telefono del destinatario del messaggio nel formato E.164
|
from | string |
Numero di telefono del destinatario del messaggio nel formato E.164 |
|
|
Canale a cui inviare. È necessario fornire sms in questo campo
|
channel | string |
Canale a cui inviare. È necessario fornire sms in questo campo |
|
|
Riferimento client di un massimo di 40 caratteri
|
client_ref | string |
Riferimento client di un massimo di 40 caratteri |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
message_uuid
|
message_uuid | string |
message_uuid |
Richiedere una verifica
Usare Verifica richiesta per generare e inviare un PIN all'utente
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Formato della risposta
|
format | True | string |
Formato della risposta |
|
È possibile trovare la chiave API nel dashboard dell'account https://dashboard.nexmo.com
|
api_key | True | string |
È possibile trovare la chiave API nel dashboard dell'account https://dashboard.nexmo.com |
|
È possibile trovare il segreto DELL'API nel dashboard https://dashboard.nexmo.com
|
api_secret | True | string |
È possibile trovare il segreto DELL'API nel dashboard https://dashboard.nexmo.com |
|
Numero di telefono cellulare o fisso da verificare. Il numero deve essere in formato E.164
|
number | True | string |
Numero di telefono cellulare o fisso da verificare. Il numero deve essere in formato E.164 |
|
Specificare il codice paese a due caratteri, verificare che formatta il numero
|
country | string |
Specificare il codice paese a due caratteri, verificare che formatta il numero |
|
|
Stringa alfanumerica a 18 caratteri, usare per personalizzare il corpo sms della richiesta
|
brand | True | string |
Stringa alfanumerica a 18 caratteri, usare per personalizzare il corpo sms della richiesta |
|
Stringa alfanumerica di 11 caratteri che rappresenta l'identità del mittente
|
sender_id | string |
Stringa alfanumerica di 11 caratteri che rappresenta l'identità del mittente |
|
|
Lunghezza del codice di verifica
|
code_length | integer |
Lunghezza del codice di verifica |
|
|
Controllare la lingua usata per la richiesta Verify
|
lg | string |
Controllare la lingua usata per la richiesta Verify |
|
|
Per quanto tempo il codice di verifica generato è valido, in secondi
|
pin_expiry | integer |
Per quanto tempo il codice di verifica generato è valido, in secondi |
|
|
Tempo di attesa in secondi tra i tentativi di recapito del codice di verifica
|
next_event_wait | integer |
Tempo di attesa in secondi tra i tentativi di recapito del codice di verifica |
|
|
Sequenza predefinita di azioni SMS e TTS per trasmettere il PIN all'utente
|
workflow_id | integer |
Sequenza predefinita di azioni SMS e TTS per trasmettere il PIN all'utente |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
status
|
status | string | |
|
ID richiesta
|
request_id | string |
Verificare il controllo
Conferma che il PIN ricevuto dall'utente corrisponde alla richiesta Verify
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Formato della risposta
|
format | True | string |
Formato della risposta |
|
Chiave API
|
api_key | True | string |
Chiave API |
|
Segreto DELL'API
|
api_secret | True | string |
Segreto DELL'API |
|
Questo è il request_id ricevuto nella risposta alla richiesta Di verifica
|
request_id | True | string |
Questo è il request_id ricevuto nella risposta alla richiesta Di verifica |
|
Codice di verifica immesso dall'utente
|
code | True | string |
Codice di verifica immesso dall'utente |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID richiesta
|
request_id | string | |
|
event_id
|
event_id | string | |
|
status
|
status | string | |
|
price
|
price | string | |
|
currency
|
currency | string | |
|
estimated_price_messages_sent
|
estimated_price_messages_sent | string |