Créer une application Vonage Messages

Dans cette rubrique, vous apprendrez à créer une application API Vonage.

Utilisez l'interface de programmation pour créer une application Messages avec l'option webhooks qui sera responsable de la réception d'un message à votre numéro Vonage de Vonage (/webhooks/messages/inbound), et vérifier les mises à jour de statut (/webhooks/mesages/status), respectivement.

Ces webhooks doivent être accessibles par les serveurs de Vonage, donc dans ce guide vous utiliserez ngrok d'exposer votre environnement de environnement de développement local à l'Internet public. Cet article explique comment installer et d'exécuter ngrok et configurer Vonage pour qu'il envoie des requêtes.

Si vous n'avez pas d'application, vous pouvez en créer une à l'aide du CLI

vonage apps create 'Your application'

✅ Creating Application
Saving private key ... Done!
Application created

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
  None Enabled

vonage apps create 'Your application'

✅ Creating Application
Saving private key ... Done!
Application created

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
  None Enabled
vonage apps create 'Your application' ✅ Creating Application Saving private key ... Done! Application created Name: Your application Application ID: 00000000-0000-0000-0000-000000000000 Improve AI: Off Private/Public Key: Set Capabilities: None Enabled

La commande renvoie un numéro d'identification de l'application (que vous devez noter) et les informations relatives à votre clé privée (que vous pouvez ignorer pour les besoins de ce guide). pouvez ignorer pour les besoins de ce guide).

Exécuter ngrok à l'aide de la commande suivante :

ngrok http 3000

Notez le nom d'hôte temporaire que ngrok et l'utiliser à la place de example.com dans la commande suivante commande :

vonage apps capabilities update 00000000-0000-0000-0000-000000000000 messages `
  --messages-inbound-url='https://example.com/webhooks/messages/inbound' `
  --messages-status-url='https://example.com/webhooks/messages/status' `
  --messages-version='v1' \
  --messages-authenticate-media                                                                                                                                                                                 [boolean]
  
✅ Fetching Application
✅ Adding messages capability to application 00000000-0000-0000-0000-000000000000

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
 MESSAGES:
    Authenticate Inbound Media: On
    Webhook Version: v1
    Status URL: [POST] https://manchuck.com/meetings/status
    Inbound URL: [POST] https://manchuck.com/meetings/inbound


vonage apps capabilities update 00000000-0000-0000-0000-000000000000 messages ^
  --messages-inbound-url='https://example.com/webhooks/messages/inbound' ^
  --messages-status-url='https://example.com/webhooks/messages/status' ^
  --messages-version='v1' \
  --messages-authenticate-media                                                                                                                                                                                 [boolean]
  
✅ Fetching Application
✅ Adding messages capability to application 00000000-0000-0000-0000-000000000000

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
 MESSAGES:
    Authenticate Inbound Media: On
    Webhook Version: v1
    Status URL: [POST] https://manchuck.com/meetings/status
    Inbound URL: [POST] https://manchuck.com/meetings/inbound
vonage apps capabilities update 00000000-0000-0000-0000-000000000000 messages \ --messages-inbound-url='https://example.com/webhooks/messages/inbound' \ --messages-status-url='https://example.com/webhooks/messages/status' \ --messages-version='v1' \ --messages-authenticate-media [boolean] ✅ Fetching Application ✅ Adding messages capability to application 00000000-0000-0000-0000-000000000000 Name: Your application Application ID: 00000000-0000-0000-0000-000000000000 Improve AI: Off Private/Public Key: Set Capabilities: MESSAGES: Authenticate Inbound Media: On Webhook Version: v1 Status URL: [POST] https://manchuck.com/meetings/status Inbound URL: [POST] https://manchuck.com/meetings/inbound