Sign inGet started

Mensajes de sticker de WhatsApp

Un mensaje de sticker lleva una URL pública de WebP que WhatsApp descarga en el momento del envío. Es el tipo de medio más simple: sin pie de imagen, sin ningún otro campo opcional al enviar.

Enviar un sticker

Configura sticker.url; no hay nada más que agregar:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  sticker: { url: "https://cdn.example.com/stickers/thumbs-up.webp" },
});
console.log(msg.id, msg.status);
sticker no tiene el campo caption, y animated no es algo que configures al enviar; Bird solo lo devuelve en un sticker entrante. from es obligatorio en cada mensaje de servicio: un número que tu espacio de trabajo posee, no uno gestionado por Bird.

Límites

CampoLímiteAplicado por
Tamaño de archivo, estático100 KBSolo WhatsApp, al descargar (async)
Tamaño de archivo, animado500 KBSolo WhatsApp, al descargar (async)
Tipo de archivoSolo WebPSolo WhatsApp, al descargar (async)
captionno es un campo válidoBird, al aceptar (422, rechazo de esquema)
urlabsoluta, https, con host, sin espacios crudosBird, al aceptar (422)
Bird verifica la forma de la URL antes de poner nada en cola; no verifica el tamaño real del archivo, su formato ni si es estático o animado. Solo la descarga propia de WhatsApp en el momento del envío puede hacerlo. Enviar un caption no es un error de longitud; el campo no existe en el esquema de este tipo, así que falla como propiedad no reconocida. Consulta en el hub envío de medios por URL y cuando un medio falla.

Leer un sticker entrante

Un sticker entrante incluye un id, mime_type y animated que Bird obtuvo al descargar el archivo. Los tres están ausentes en una lectura de un envío saliente, ya que Bird nunca descargó ni inspeccionó el archivo que envió. Consulta Recibir stickers de WhatsApp para la lectura entrante completa, el payload whatsapp.received y qué tener en cuenta.

Límites y modos de fallo

  • La ventana de servicio al cliente debe estar abierta. Los stickers son mensajes de servicio, entregables solo dentro de una ventana abierta; consulta en el hub la ventana de servicio al cliente.
  • Bird rechaza http; WhatsApp sí lo descargaría. Consulta en el hub envío de medios por URL para la verificación completa de forma.
  • Una descarga rechazada se cobra de todas formas. Consulta en el hub cuando un medio falla. El texto de rechazo propio de sticker de WhatsApp no se ha medido de forma independiente, así que trata la correspondencia como inferida por simetría en vez de confirmada por causa.
  • animated es de solo lectura y solo está presente en un sticker entrante o descargado. Es el veredicto propio de WhatsApp sobre el archivo, no algo que puedas declarar. Que un sticker sea estático o animado solo cambia su límite de tamaño; WebP es obligatorio en ambos casos.
  • WhatsApp guarda en caché una URL descargada durante unos 10 minutos. Reenviar la misma URL dentro de esa ventana sirve la primera descarga de nuevo; varía la URL para forzar una nueva.

Próximos pasos