Numbers

Les Numbers sont un concept clé à comprendre lorsque l'on travaille avec l'API Voice de Vonage. Les points suivants doivent être pris en compte avant de développer votre Applications Vonage.

Formatage

Dans Vonage Voice (API ou SIP Trunking), tous les numéros sont au format E.164. Cela signifie que les numéros :

  • Omettre à la fois le début et la fin de l'article + et le code d'accès international tel que 00 ou 001.
  • Ne pas contenir de caractères spéciaux, tels que des espaces, () ou -

Par exemple, un numéro américain aurait le format suivant 14155550101. Un numéro britannique aurait le format suivant 447700900123.

Si vous n'êtes pas sûr de la manière de formater le nombre, le bouton Number Insight API peut être utilisé pour trouver des informations correctes sur un nombre.

Numéros de Vonage

Vonage propose des numéros de location situés dans de nombreux pays du monde. Dans certains pays, les numéros peuvent être activés pour les SMS ou la voix uniquement, ou dans d'autres, ils prendront en charge les deux.

Vonage peut également fournir des numéros dans les gammes "fixe" et "mobile" pour de nombreux pays. Vous pouvez rechercher et louer un numéro disponible :

Identification de l'appelant sortant

Lors d'un appel sortant, l'ID de l'appelant est l'identifiant de l'appelant. from dans le Appeler l'API ou relier pour Voice API. Il se trouve également dans le fichier SIP INVITE pour le SIP Trunking ; il se trouve dans la section PAI s'il est défini, sinon il sera dans l'en-tête From de l'en-tête. Vous pouvez utiliser les numéros suivants pour l'identification de l'appelant :

  • Un numéro Vonage associé à votre Account sans limitation d'appels sortants (voir le champ Limitations dans la section Acheter des Numbers ou vérifier auprès du service d'assistance).
  • Un numéro de non-Vonage après avoir fourni les informations requises sur la preuve de propriété. Sous réserve de restrictions géographiques, Contacter l'assistance pour que votre numéro soit enregistré en tant qu'identifiant d'appelant vérifié.
  • L'identification originale de l'appelant de la partie qui appelle votre numéro Vonage (uniquement applicable pour le type de terminal téléphonique). Ceci est utile pour les scénarios de renvoi d'appel ou de suivi d'appel. Par exemple, lorsque vous recevez un appel de 15551111111 à votre numéro Vonage 15552222222vous pouvez effectuer un appel sortant avec action de connexion vers un numéro de téléphone. 15553333333 utiliser l'identification originale de l'appelant 15551111111 comme numéro de départ.

Remarque : cette fonction n'est prise en charge que pour les appels nationaux, c'est-à-dire que les trois numéros doivent se trouver dans le même pays et ne pas faire l'objet de restrictions imposées par les autorités de régulation locales.

Tout autre numéro utilisé pour l'identification de l'appelant entraînera le blocage de l'appel.

Identification de l'appelant

Pour utiliser un numéro que vous avez loué auprès de Vonage avec votre application vocale, vous devez lier ce numéro à l'application via l'option Tableau de bord sur la page Applications, ou en utilisant le bouton API Numbers. Pour le SIP Trunking, vous devez relier le numéro à votre domaine SIP via l'option Tableau de bord SIP. Vous pouvez relier plusieurs numéros à la même application, et le numéro qui a été appelé sera transmis à votre answer_url dans le to ou dans le paramètre To dans le protocole SIP INVITE pour le SIP Trunking.

Lors de la réception d'un appel, l'identifiant de l'appelant est envoyé dans le message d'accueil. Réponse webhook en tant que from ou en tant que From dans l'en-tête SIP INVITE pour le SIP Trunking.

{
  "from": "442079460000",
  "to": "447700900000",
  "uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
  "conversation_uuid": "CON-aaaaaaaa-bbbb-cccc-dddd-0123456789ab"
}

Vonage tente de vous présenter l'identification de l'appelant de la partie qui appelle votre application Vonage au format international. Cependant, il peut arriver que le réseau d'origine ne respecte pas ce format. Vonage transmet le numéro reçu du fournisseur du numéro. Pour en savoir plus sur l'identification de l'appelant à l'arrivée, consultez notre site web aperçu des fonctions vocales dans la base de connaissances de Vonage.