Cómo enviar y recibir eventos de mensajes

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.

Esta guía explica cómo enviar y recibir eventos de mensajes con el Vonage Client SDK. Antes de empezar, asegúrate de haber añadido el SDK a tu aplicación y de haber creado una sesión (Android, iOS, JS), y se unió a una conversación.

Envío de mensajes de texto Eventos

Dado un ID de Conversación, puedes enviar un Evento de Mensaje de Texto.

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

Envío de mensajes y eventos relacionados con imágenes

Si dispones del ID de la conversación y de la URL de una imagen, puedes enviar un evento de mensaje con imagen.

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

Envío de mensajes Eventos personalizados

Además del identificador de conversación, puedes enviar una carga útil totalmente personalizada como un evento de mensaje personalizado. Esto resulta útil si deseas un tipo de evento de mensaje específico para tu aplicación.

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

Recepción de eventos de mensajes

Puedes recibir todos los eventos de mensajes de conversación en tu aplicación configurando un oyente de eventos o una función delegada. Los eventos de mensajes recibidos a través de este oyente o función delegada se actualizarán automáticamente en el delivered Estado. Aquí puede comprobar el tipo de Evento de Mensaje entrante.

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

Marcar eventos de mensajes como vistos

Una vez que haya recibido un Evento de Mensaje, puede marcarlo como visto.

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