メッセージイベントの送受信方法

Product deprecation notice

Effective April 30th, 2026, Vonage In-App Messaging will no longer be available. Access for new users will be closed, and the service will be discontinued for all existing users.

If you have any questions regarding this product’s discontinuation, please contact your account manager or our support team.

このガイドでは、Vonage Client SDKでメッセージイベントを送受信する方法を説明します。始める前に、アプリにSDKを追加し、セッション(アンドロイド, iOS, JSそして 会話に参加.

メッセージ・テキスト・イベントの送信

会話IDを指定すると、テキストメッセージイベントを送信できます。

client.sendMessageTextEvent(conversationId, "Hi Vonage!")
    .then(timestamp => {
        console.log("Successfully sent text message at ", timestamp);
    }).catch(error => {
        console.error("Error sending text message: ", error);
    });

メッセージ画像イベントの送信

画像の会話IDとURLがあれば、画像メッセージイベントを送信できます。

client.sendMessageImageEvent(conversationId, imageURL)
    .then(timestamp => {
        console.log("Successfully sent image message at ", timestamp);
    }).catch(error => {
        console.error("Error sending image message: ", error);
    });

メッセージ・カスタム・イベントの送信

会話 ID と共に、完全にカスタムなペイロードをカスタム・メッセージ・イベントとして送信することができます。これは、アプリケーションに特化したメッセージ・イベント・タイプが欲しい場合に便利です。

const attachmentPayload = {
    key1: "value 1",
    key2: "value 2"
};
      
client.sendMessageCustomEvent(conversationId, attachmentPayload)
    .then(timestamp => {
        console.log("Successfully sent custom message at ", timestamp);
    }).catch(error => {
        console.error("Error sending custom message: ", error);
    });

メッセージイベントの受信

Event Listener/Delegate Functionを設定することで、アプリケーション内のすべての会話 Message Eventsを受信することができます。このリスナー/デリゲートを介して受信されたメッセージイベントは、自動的に delivered の状態です。ここで、受信メッセージイベントの種類を確認できます。

client.on("conversationEvent", event => {
    switch (event.kind) {
        case "message:text":
            handleTextMessage(event);
            break;
        case "message:image":
            handleImageMessage(event);
            break;
        case "message:custom":
            handleCustomMessage(event);
            break;
    };
});

メッセージイベントを既読にする

メッセージイベントを受信したら、それを見たものとしてマークすることができます。

client.sendMessageSeenEvent(eventId, conversationId)
    .then(timestamp => {
        console.log("Successfully sent seen event at ", timestamp);
    }).catch(error => {
        console.error("Error sending seen event: ", error);
    });