L'API Messages de Vonage fait maintenant partie de nos SDK de serveur

Mise à jour : L'API Messages de Vonage prend désormais en charge RCS (Rich Communication Services) dans tous nos SDK de serveur ! RCS permet une messagerie riche et interactive avec des fonctionnalités telles que les réponses suggérées, les cartes riches, les reçus de lecture et le contenu de marque. En savoir plus sur les messages RCS dans notre documentation et dans notre dernière annonce, "RCS Business Messaging est maintenant GA dans l'API Messages de Vonage".

API de Vonage Messages API de Vonage offre aux développeurs la possibilité d'intégrer la fonctionnalité de messagerie dans leurs Applications à travers de multiples canaux tels que les SMS, MMS, WhatsApp, Facebook Messengeret Viber.

Jusqu'à présent, si vous vouliez utiliser l'API Messages, vous deviez accéder directement au point de terminaison. Cela signifiait qu'il fallait traiter toutes les questions de bas niveau, telles que la gestion du cycle demande/réponse, la création d'en-têtes, l'authentification et la sérialisation des données.

Je suis très heureux d'annoncer que nos SDK serveur prennent désormais en charge l'API Messages. Donc, si vous êtes un développeur travaillant avec Ruby, Node, PHP, Python, Javaou .NETvous pouvez laisser nos SDK s'occuper des détails de bas niveau pour vous et vous concentrer sur la création de votre application !

Jetons un coup d'œil à quelques-unes des choses que vous pouvez faire en utilisant l'API Messages via nos SDK.

SMS

L'API Messages permet notamment d'envoyer des SMS. Vous avez peut-être déjà envoyé des SMS à l'aide de nos SDK serveur via notre SMS API. Vous avez désormais la possibilité d'utiliser soit l'API SMS, soit l'API Messages pour envoyer des messages SMS.

Il existe quelques différences entre les deux API. Les options d'authentification et la configuration des webhooks en sont quelques exemples. Il existe également des différences dans la manière dont ces différentes API sont mises en œuvre dans nos SDK de serveur.

Voici des exemples d'envoi de SMS via l'API Messages en utilisant le Ruby SDK et Node SDK.

SDK Ruby

# instantiating a client object
client = Vonage::Client.new(
  application_id: '76543a12-1b87-4c32-a1b2-1d9876543210',
  private_key: File.read('private.key')
)

# creating an SMS message object
message = Vonage::Messaging::Message.sms(
  message: "A SMS message sent using the Vonage Messages API"
)

# sending the SMS
response = client.messaging.send(
  from: '447700900000',
  to: '447700900001',
  **message
)

SDK Node

// initializing dependencies
const Vonage = require('@vonage/server-sdk')
const SMS = require('@vonage/server-sdk/lib/Messages/SMS');
const fs = require('fs');

// reads the private key file
let privateKey = fs.readFileSync('private.key', 'utf8');

// instantiating a client object
const vonage = new Vonage({
  apiKey: VONAGE_API_KEY,
  apiSecret: VONAGE_API_SECRET,
  applicationId: '76543a12-1b87-4c32-a1b2-1d9876543210',
  privateKey: privateKey
})

// sending the SMS
vonage.messages.send(
  new SMS("This is an SMS text message sent using the Messages API", '447700900001', '447700900000'),
  (err, data) => {
    if (err) {
      console.error(err);
    } else {
      console.log(data.message_uuid);
    }
  }
);

MMS

Un autre canal de l'API Messages est désormais disponible dans les SDK : le MMS (Multimedia Message Service). Ce canal vous permet d'envoyer des messages contenant des contenus multimédias tels que des images, des fichiers audio, des vidéos et des vCards (.vcf ).

Voici un exemple d'envoi d'un message MMS image à l'aide du NET SDK.

var credentials = Credentials.FromApiKeyAndSecret(
  "76543a12-1b87-4c32-a1b2-1d9876543210",
  "abc123"
);

var vonageClient = new VonageClient(credentials);

var request = new Vonage.Messages.Mms.MmsImageRequest
{
    To = "447700900000",
    From = "447700900001",
    Image = new Attachment
    {
        Url = "https://example.com/image.jpg"
    }
};

var response = await vonageClient.MessagesClient.SendAsync(request);

WhatsApp

WhatsApp est un canal de messagerie dont la popularité a explosé ces dernières années. Dans un contexte professionnel, WhatsApp est idéal pour la messagerie transactionnelle et convient parfaitement aux cas d'utilisation du commerce conversationnel. Avec l'API Messages de Vonage, vous pouvez envoyer et recevoir des messages WhatsApp à l'aide d'un WhatsApp Business Account. Avec l'intégration de Messages dans les SDK, il est encore plus facile d'incorporer les flux de messagerie WhatsApp dans vos applications.

L'API Messages prend en charge de nombreux types de messages WhatsApp, notamment le texte, l'image, l'audio et la vidéo, et d'autres types de messages seront bientôt ajoutés ! Pour en savoir plus sur la messagerie WhatsApp et la création d'un WhatsApp Business Account.

Voici un exemple d'envoi d'un message vidéo WhatsApp à l'aide du PHP SDK.

// creating a Keypair object using private key and app id
$keypair = new \Vonage\Client\Credentials\Keypair(
    file_get_contents('private.key'),
    '76543a12-1b87-4c32-a1b2-1d9876543210'
);

// instantiating a Client object using the Keypair
$client = new \Vonage\Client($keypair);


// instantiating a VideoObject message attachment
$videoObject = new \Vonage\Messages\MessageObjects\VideoObject(
    'https://example.com/video.mp4',
    'This is an video file'
);

// instantiating a WhatsAppVideo message which contains the VideoObject attachment
$whatsApp = new \Vonage\Messages\MessageType\WhatsApp\WhatsAppVideo(
    '447700900001',
    '447700900000',
    $videoObject
);

// sending the WhatsAppVideo message
$client->send($whatsApp);

Facebook Messenger

De la même manière que WhatsApp, l'API Messages vous permet d'utiliser Facebook Messenger dans un contexte professionnel afin d'activer les conversations entre les utilisateurs de Facebook et les pages Facebook. Là encore, il existe plusieurs types de messages au sein de ce canal, tels que le texte, l'image, l'audio, la vidéo et le fichier.

Vous pouvez en savoir plus sur Messenger dans notre documentation, et consulter l'exemple ci-dessous d'utilisation du SDK Java pour envoyer un message audio Messenger.

var client = VonageClient.builder()
    .applicationId("76102c93-1d87-4a13-a1d5-1c9863095337")
    .privateKeyPath("/path/to/private.key")
    .build();

var message = MessengerAudioRequest.builder()
    .from("9876543210").to("0123456789")
    .url("https://example.com/audio.mp3")
    .build();

var response = client.getMessagesClient().sendMessage(message);

Viber

Viber est un autre canal de messagerie disponible dans l'API Messages. Viber peut être utilisé pour envoyer des messages texte ou image. Pour en savoir plus sur Viber dans notre documentation.

Vous trouverez ci-dessous un exemple de la manière dont vous pouvez envoyer un message texte Viber à l'aide du Python SDK.

# initializing dependencies
import vonage

# instantiating a Client object with app id and private key
client = vonage.Client(
    application_id='76543a12-1b87-4c32-a1b2-1d9876543210',
    private_key='private.key',
)

# sending a message using the Messages object's send_message method
client.messages.send_message(
    {
        'channel': 'viber_service',
        'message_type': 'text',
        'to': '447700900000',
        'from': '9876543210',
        'text': 'This is a Viber message from the Vonage Messages API'
    }
)

Vous voulez commencer à utiliser l'API Messages dès aujourd'hui ? Créez un compte gratuit de Account du développeur de Vonageinstallez le SDK serveur pour votre langage de programmation préféré et essayez certains des exemples de code dans notre documentation !