Skip to main content
POST
Enviar un mensaje del visitante

Authorizations

Authorization
string
header
required

La API key de tu organización, con la forma rvm_<prefijo>.<secreto>, enviada como Authorization: Bearer rvm_…. Revem la emite y sólo se muestra una vez; si la pierdes se reemplaza, no se recupera.

Body

application/json

Un mensaje necesita body, attachments o ambos. Para abrir una conversación nueva se omite conversationId y se indica quién escribe en contact.

conversationId
string<uuid>

Conversación existente en la que escribe el visitante. Es el valor que devolvió el primer mensaje. Cuando viene, channelId y contact se ignoran.

channelId
string<uuid>

Canal de webchat en el que abrir la conversación. Si se omite se usa el webchat más antiguo del tenant. Sólo se lee cuando no hay conversationId.

contact
object

Quién escribe, para una conversación nueva. Hace falta al menos id, email o phone. Se prueban en ese orden: id manda y no crea contactos; email y phone buscan un contacto existente o lo crean.

body
string

Texto del mensaje, hasta 4000 caracteres. Obligatorio si no hay adjuntos.

Required string length: 1 - 4000
attachments
object[]

Adjuntos subidos previamente con POST /webchat/media, hasta 20 por mensaje. Obligatorio si no hay body.

Maximum array length: 20

Response

Mensaje guardado.

conversationId
string<uuid>
required

La conversación del mensaje. En un primer mensaje es nueva; envíala en los siguientes y úsala para leer las respuestas.

messageId
integer
required

Identificador del mensaje guardado.