Vonage (préversion)
La plateforme d’API Vonage vous permet d’ajouter des communications dans le contexte de vos applications, notamment sms, voix et conversation. Inscrivez-vous à un compte Nexmo ici - https://www.vonage.com/
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge de Vonage |
| URL | https://www.vonage.co.uk/support |
| Messagerie électronique | support@vonage.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Vonage |
| Site internet | https://vonage.com |
| Politique de confidentialité | https://www.vonage.com/legal/privacy-policy |
| Catégories | Communication |
La plateforme d’API Vonage vous permet d’ajouter des communications dans le contexte de vos applications, notamment sms, voix et conversation.
Prerequisites
Vous devez procéder comme suit :
- Un compte Vonage, inscrivez-vous à https://dashboard.nexmo.com/sign-up
Comment obtenir des informations d’identification
Pour obtenir des informations d’identification, vous pouvez vous inscrire à un compte Vonage gratuit à l’adresse https://dashboard.nexmo.com/sign-up
Problèmes connus et limitations
Actuellement, ce connecteur n’expose pas tous les produits et API Vonage
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Demander une vérification |
Utiliser la demande De vérification pour générer et envoyer un code confidentiel à votre utilisateur |
| Envoyer un message au canal donné |
Envoyer un message |
| Fournit des informations de base sur un nombre |
Fournit des informations de base sur un nombre |
| Fournit des informations d’insights sur les nombres standard sur un nombre |
Fournit des informations d’insights sur les nombres standard sur un nombre |
| Vérifier la vérification |
Confirme que le code confidentiel que vous avez reçu de votre utilisateur correspond à la demande de vérification |
Demander une vérification
Utiliser la demande De vérification pour générer et envoyer un code confidentiel à votre utilisateur
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Format de réponse
|
format | True | string |
Format de réponse |
|
Vous trouverez votre clé API dans le tableau de bord de votre compte https://dashboard.nexmo.com
|
api_key | True | string |
Vous trouverez votre clé API dans le tableau de bord de votre compte https://dashboard.nexmo.com |
|
Vous pouvez trouver votre secret d’API dans votre tableau de bord https://dashboard.nexmo.com
|
api_secret | True | string |
Vous pouvez trouver votre secret d’API dans votre tableau de bord https://dashboard.nexmo.com |
|
Numéro de téléphone mobile ou fixe à vérifier. Le nombre doit être au format E.164
|
number | True | string |
Numéro de téléphone mobile ou fixe à vérifier. Le nombre doit être au format E.164 |
|
Spécifiez le code de pays à deux caractères, vérifiez ensuite le format du nombre
|
country | string |
Spécifiez le code de pays à deux caractères, vérifiez ensuite le format du nombre |
|
|
Chaîne alphanumérique de 18 caractères, utilisée pour personnaliser le corps sms de la requête
|
brand | True | string |
Chaîne alphanumérique de 18 caractères, utilisée pour personnaliser le corps sms de la requête |
|
Chaîne alphanumérique de 11 caractères qui représente l’identité de l’expéditeur
|
sender_id | string |
Chaîne alphanumérique de 11 caractères qui représente l’identité de l’expéditeur |
|
|
Longueur du code de vérification
|
code_length | integer |
Longueur du code de vérification |
|
|
Contrôler la langue utilisée pour la requête De vérification
|
lg | string |
Contrôler la langue utilisée pour la requête De vérification |
|
|
Durée pendant laquelle le code de vérification généré est valide pendant, en secondes
|
pin_expiry | integer |
Durée pendant laquelle le code de vérification généré est valide pendant, en secondes |
|
|
Temps d’attente en secondes entre les tentatives de remise du code de vérification
|
next_event_wait | integer |
Temps d’attente en secondes entre les tentatives de remise du code de vérification |
|
|
Séquence prédéfinie d’actions SMS et TTS pour transmettre le code confidentiel à votre utilisateur
|
workflow_id | integer |
Séquence prédéfinie d’actions SMS et TTS pour transmettre le code confidentiel à votre utilisateur |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
status
|
status | string | |
|
identifiant_de_demande
|
request_id | string |
Envoyer un message au canal donné
Envoyer un message
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Type de contenu pour la requête
|
Content-Type | True | string |
Type de contenu |
|
Type de date accepté
|
Accept | True | string |
Accept |
|
Type de message à envoyer. Vous devez fournir du texte dans ce champ
|
message_type | string |
Type de message à envoyer. Vous devez fournir du texte dans ce champ |
|
|
Texte du message à envoyer ; limité à 1 000 caractères
|
text | string |
Texte du message à envoyer ; limité à 1 000 caractères |
|
|
Numéro de téléphone du destinataire du message au format E.164
|
to | string |
Numéro de téléphone du destinataire du message au format E.164 |
|
|
Numéro de téléphone du destinataire du message au format E.164
|
from | string |
Numéro de téléphone du destinataire du message au format E.164 |
|
|
Canal à envoyer. Vous devez fournir des sms dans ce champ
|
channel | string |
Canal à envoyer. Vous devez fournir des sms dans ce champ |
|
|
Référence du client d’un maximum de 40 caractères
|
client_ref | string |
Référence du client d’un maximum de 40 caractères |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
message_uuid
|
message_uuid | string |
message_uuid |
Fournit des informations de base sur un nombre
Fournit des informations de base sur un nombre
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Format de réponse
|
format | True | string |
Format de réponse |
|
Votre clé API
|
api_key | True | string |
Votre clé API |
|
Votre secret d’API
|
api_secret | True | string |
Votre secret d’API |
|
Numéro de téléphone dont vous avez besoin d’informations sur le format national ou international
|
number | True | string |
Numéro de téléphone dont vous avez besoin d’informations sur le format national ou international |
|
Code pays à deux caractères au format ISO 3166-1 alpha-2, par exemple. Go ou États-Unis
|
country | True | string |
Code pays à deux caractères au format ISO 3166-1 alpha-2, par exemple. Go ou États-Unis |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
status
|
status | integer | |
|
status_message
|
status_message | string | |
|
identifiant_de_demande
|
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 |
Fournit des informations d’insights sur les nombres standard sur un nombre
Fournit des informations d’insights sur les nombres standard sur un nombre
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Format de réponse
|
format | True | string |
Format de réponse |
|
Votre clé API
|
api_key | True | string |
Votre clé API |
|
Votre secret d’API
|
api_secret | True | string |
Votre secret d’API |
|
Numéro de téléphone dont vous avez besoin d’informations sur le format national ou international
|
number | True | string |
Numéro de téléphone dont vous avez besoin d’informations sur le format national ou international |
|
Code pays à deux caractères au format ISO 3166-1 alpha-2, par exemple. Go ou États-Unis
|
country | True | string |
Code pays à deux caractères au format ISO 3166-1 alpha-2, par exemple. Go ou États-Unis |
|
Défini sur true pour recevoir le nom du propriétaire du numéro de téléphone dans la réponse
|
cnam | string |
Défini sur true pour recevoir le nom du propriétaire du numéro de téléphone dans la réponse |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
status
|
status | integer | |
|
status_message
|
status_message | string | |
|
identifiant_de_demande
|
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 | |
|
nom
|
current_carrier.name | string | |
|
country
|
current_carrier.country | string | |
|
network_type
|
current_carrier.network_type | string | |
|
network_code
|
original_carrier.network_code | string | |
|
nom
|
original_carrier.name | string | |
|
country
|
original_carrier.country | string | |
|
network_type
|
original_carrier.network_type | string | |
|
Porté
|
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 |
Vérifier la vérification
Confirme que le code confidentiel que vous avez reçu de votre utilisateur correspond à la demande de vérification
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Format de réponse
|
format | True | string |
Format de réponse |
|
Votre clé API
|
api_key | True | string |
Votre clé API |
|
Votre secret d’API
|
api_secret | True | string |
Votre secret d’API |
|
Il s’agit de la request_id que vous avez reçue dans la réponse à la demande de vérification
|
request_id | True | string |
Il s’agit de la request_id que vous avez reçue dans la réponse à la demande de vérification |
|
Code de vérification entré par votre utilisateur
|
code | True | string |
Code de vérification entré par votre utilisateur |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
identifiant_de_demande
|
request_id | string | |
|
event_id
|
event_id | string | |
|
status
|
status | string | |
|
price
|
price | string | |
|
monnaie
|
currency | string | |
|
estimated_price_messages_sent
|
estimated_price_messages_sent | string |