Enviar un mensaje de texto por WhatsApp

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Body Params

Objeto de contacto que necesita ser agregado

El destinatario se identifica con uno de estos tres campos: wa_id (teléfono),
bsuid o wa_username. Al menos uno es obligatorio.

Meta permite a los usuarios de WhatsApp ocultar su número de teléfono. Esos
contactos no tienen wa_id: se identifican por su bsuid (identificador que asigna
Meta) o, más práctico, por su wa_username, que es el que se ve en el chat y en el
export de contactos.

message

string

required

wa_id

string

length ≤ 140

Identificador del destinatario. Acepta teléfono, BSUID o username — el que tenga a
mano, en este mismo campo.

La detección es por formato y sin ambigüedad:

Valor	Se interpreta como
`XX.<alfanumérico>`	BSUID
Dígitos que formen un número válido (con o sin `+`, espacios o guiones)	teléfono
Cualquier otra cosa	username de WhatsApp

Si envía el BSUID de un contacto cuyo teléfono Wasapi ya conoce, se normaliza al
teléfono: la conversación de esa persona vive bajo su número, y enviar por BSUID
partiría el historial en dos hilos.

Los campos bsuid y wa_username siguen disponibles si prefiere ser explícito.

bsuid

string | null

Business-Scoped User ID de Meta, con formato XX.<alfanumérico>. Identifica a un
contacto que oculta su número. Se obtiene del campo bsuid de los webhooks o de
GET /conversations.

Alternativa explícita a poner el BSUID directamente en el campo del destinatario.

wa_username

string | null

Username público de WhatsApp del destinatario. Wasapi lo resuelve al contacto y envía
por su teléfono o su BSUID, según cuál conozca.

⚠️ Solo funciona con contactos que Wasapi ya conoce: Meta no ofrece búsqueda por
username, así que no se puede escribir a alguien nunca visto. Si no existe, 422.

⚠️ El username es mutable y reasignable. Sirve para encontrar al contacto, no como
identificador estable: para eso use el uuid del contacto.

from_id

integer

Identificador del número de teléfono (obtenible en el endpoint /whatsapp-numbers)

200Operación exitosa