Skip to main content
POST
Enviar una plantilla de WhatsApp

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
sender
object
required

Exactamente uno: phoneNumberId (ID de Meta) o phoneNumber (teléfono internacional con código de país, sin espacios). Debe pertenecer a tu organización.

to
string
required

Teléfono del destinatario con código de país, sin espacios. El + es opcional.

Pattern: ^\+?[1-9]\d{6,14}$
templateName
string
required

Nombre exacto de la plantilla aprobada en la cuenta del remitente.

Maximum string length: 512
Pattern: ^[a-z0-9_]+$
languageCode
string
required

Idioma exacto de la plantilla, por ejemplo es o es_CL.

Pattern: ^[a-z]{2,3}(?:_[A-Z]{2})?$
variables
object

Mapas de claves y valores de texto, separados en header y body. Usa nombres sin llaves (nombre) o posiciones (1, 2). buttons usa el índice del botón desde cero y el sufijo de su URL dinámica. No se aceptan claves faltantes ni desconocidas.

mediaId
string<uuid>

ID de una imagen previamente guardada en Revem para esta plantilla. Obligatorio sólo para cabeceras IMAGE. Cabeceras de video/documento y botones especiales no se admiten.

contactName
string

Nombre utilizado al resolver el contacto destinatario.

Required string length: 1 - 200

Response

Mensaje aceptado y registrado; IDs de conversación y ticket.

ok
boolean
required
conversationId
string<uuid> | null
required
ticketId
string<uuid> | null
required