Premiers pas avec l'API Messages

Cette page vous guidera à travers toutes les étapes nécessaires pour être opérationnel avec l'API Messages de Vonage. L'API Messages offre un moyen simple d'envoyer des messages à vos clients par le biais de plusieurs canaux populaires - SMS, MMS, RCS, WhatsApp, Facebook et Viber. Au lieu d'intégrer chaque plateforme séparément, vous pouvez vous connecter une seule fois et gérer toutes les conversations en un seul endroit.

Pour commencer, suivez ce guide pour créer votre Account et votre application. Ensuite, naviguez jusqu'au guide de démarrage de votre chaînes choisies pour terminer l'intégration.

Conditions préalables

Avant d'envoyer votre premier message, vous devrez créer un compte et une application Vonage :

Créer un Account Vonage

Pour créer votre Account Vonage gratuit :

  1. Dans votre navigateur, naviguez vers Tableau de bord.
  2. Ajoutez les informations relatives à votre entreprise et cliquez sur S'inscrire. Vonage envoie un NIP à votre téléphone sous forme de message texte ou d'appel téléphonique automatisé. Le délai d'attente pour chaque tentative de vérification est de 5 minutes.
    NoteNumbers : vous ne pouvez associer un numéro de téléphone qu'à un seul Account. Si votre numéro de téléphone est déjà associé à un compte Vonage, vous devez supprimer ce numéro de téléphone du compte existant.
  3. En Vérification du numéro de téléphoneentrez le NIP qui vous a été envoyé par Vonage et cliquez sur Verify. Vous êtes connecté au tableau de bord et on vous montre comment commencer à développer avec Vonage. Cette page s'affiche chaque fois que vous vous connectez jusqu'à ce que vous ayez effectué votre premier appel réussi avec les API de Vonage.

Lorsque vous créez votre compte Vonage, vous recevez 2 € de crédit de test gratuit et votre compte est mis en mode DEMO. Vous pouvez utiliser nos produits pour envoyer des messages à un maximum de 10 numéros de destination. Un message indiquant que le compte est en mode démo est ajouté à tous les SMS que vous envoyez. Pour sortir du mode démo ajouter un crédit à votre Account.

Pour un très petit nombre de pays, Vonage ne peut pas créer automatiquement un Account pour vous. Cela est dû à des restrictions de paiement ou à des restrictions commerciales légales pour une société enregistrée aux États-Unis.

Créer une application API Vonage

Il existe deux méthodes alternatives pour créer une application Messages :

  1. Utilisation de la CLI de Vonage
  2. Utilisation du tableau de bord

Chacune de ces méthodes est décrite dans les sections suivantes.

Comment créer une application Messages à l'aide de la CLI de Vonage

Pour créer votre application à l'aide de la CLI de Vonage, entrez la commande suivante dans l'interpréteur de commandes :

vonage apps:create "My Messages App" --messages_inbound_url=https://example.com/webhooks/inbound-message --messages_status_url=https://example.com/webhooks/message-status

Cela permet de créer une application API Vonage avec des messages capacitéavec les URL des webhooks configurés comme spécifié, et générer un fichier de clé privée my_messages_app.key et crée ou met à jour le vonage_app.json fichier.

Comment créer une application Messages à l'aide du tableau de bord

Vous pouvez créer une application Messages dans l'application Tableau de bord.

Pour créer votre application à l'aide du tableau de bord :

  1. Sous Applications dans le tableau de bord, cliquez sur le bouton Créer une nouvelle application bouton.

  2. Sous Nom, saisissez le nom de l'Applications. Choisissez un nom pour faciliter les références futures.

  3. Cliquez sur le bouton Générer une clé publique et une clé privée. Cela créera une paire de clés publique/privée et la clé privée sera téléchargée par votre navigateur.

  4. Sous Capacités sélectionner le Messages bouton.

  5. Dans le cadre de la URL entrant entrez l'URL de votre webhook de messages entrants, par exemple, https://example.com/webhooks/inbound-message.

  6. Dans le cadre de la URL de l'état entrez l'URL de votre webhook sur l'état des messages, par exemple, https://example.com/webhooks/message-status.

  7. Cliquez sur le bouton Générer une nouvelle application bouton. Vous passez à l'étape suivante de la procédure de création d'une application, où vous pouvez associer un numéro API de Vonage à l'application, et lier des comptes externes tels que Facebook à cette application.

  8. S'il existe un Account externe auquel vous souhaitez lier cette application, cliquez sur le bouton Comptes externes liés et cliquez sur l'onglet correspondant Lien pour le compte auquel vous voulez vous relier.

Vous avez maintenant créé votre application.

NOTE : Avant de tester votre application, assurez-vous que vos webhooks sont configurés et que votre serveur webhook fonctionne.

Sections de démarrage spécifiques à chaque canal