Comment envoyer et recevoir des événements de messages

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.

Ce guide explique comment envoyer et recevoir des événements de message avec le Client SDK de Vonage. Avant de commencer, assurez-vous d'avoir ajouté le SDK à votre application, créé une session (Android, iOS, JS), et a rejoint une conversation.

Envoi d'événements textuels

Vous pouvez envoyer un événement par message texte à partir d'un identifiant de conversation.

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

client.sendMessageTextEvent("CONV_ID", "Hello world!") { error, timestamp ->
    error?.takeIf { it is VGError }?.let {/* Handle Vonage Error */ } ?:
    error?.let {/* Handle generic Error */ }
    timestamp?.let { /* Message sent at timestamp */ }
}

client.sendMessageTextEvent("CONV_ID", text: "Hello world!") { error, timestamp in
    ...
}

Envoi d'un message Événements d'image

Si vous disposez d'un identifiant de conversation et de l'URL d'une image, vous pouvez envoyer un événement de message d'image.

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

client.sendMessageImageEvent("CONV_ID", URL("MY_IMAGE_URL")) { error, timestamp ->
    error?.takeIf { it is VGError }?.let {/* Handle Vonage Error */ } ?:
    error?.let {/* Handle generic Error */ }
    timestamp?.let { /* Message sent at timestamp */ }
}

client.sendMessageImageEvent("CONV_ID", imageUrl: "MY_IMAGE_URL") { error, timestamp in
    ...
}

Envoi d'un message Événements personnalisés

En plus d'un identifiant de conversation, vous pouvez envoyer une charge utile entièrement personnalisée en tant qu'événement de message personnalisé. Cette fonction est utile si vous souhaitez un type d'événement de message spécifique à votre application.

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);
    });

client.sendMessageCustomEvent("CONV_ID", "MY_CUSTOM_DATA") { error, timestamp ->
    error?.takeIf { it is VGError }?.let {/* Handle Vonage Error */ } ?:
    error?.let {/* Handle generic Error */ }
    timestamp?.let { /* Message sent at timestamp */ }
}

client.sendMessageCustomEvent("CONV_ID", customData: "MY_CUSTOM_DATA") { error, timestamp in
    
}

Réception de messages

Vous pouvez recevoir tous les événements de messages de conversation dans votre application en mettant en place une fonction d'écoute/délégation d'événements. Les événements de message reçus par l'intermédiaire de cette fonction d'écoute/déléguée seront automatiquement mis à jour dans le fichier delivered état. Vous pouvez ici vérifier le type d'événement de message entrant.

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.setOnConversationEventListener {
    when(it) {
        is MessageCustomEvent -> {} // Handle Message Custom
        is MessageImageEvent -> {} // Handle Message Image
        is MessageTextEvent -> {} // Handle Message Text
    }
}

func chatClient(_ client: VGChatClient, didReceiveConversationEvent event: VGConversationEvent) {
    switch event.kind {
    case .messageText:
        // Handle Message Text
        let messageTextEvent = event as! VGMessageTextEvent
    case .messageImage:
        // Handle Message Image
        let messageImageEvent = event as! VGMessageImageEvent
    case .messageCustom:
        // Handle Message Custom
        let messageCustomEvent = event as! VGMessageCustomEvent
    ...
    }
}

Marquer les événements du message comme vus

Une fois que vous avez reçu un événement de message, vous pouvez le marquer comme vu.

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

client.sendMessageSeenEvent("EVENT_ID", "CONV_ID") { error, timestamp ->
    error?.takeIf { it is VGError }?.let {/* Handle Vonage Error */ } ?:
    error?.let {/* Handle generic Error */ }
    timestamp?.let { /* Message seen sent at timestamp */ }
}

client.sendMessageSeenEvent("EVENT_ID", "CONV_ID") { error, timestamp in
    ...
}