Sign inGet started

Messages sticker WhatsApp

Un message sticker contient une URL WebP publique que WhatsApp récupère au moment de l'envoi. C'est le type de média le plus simple : pas de légende, pas d'autre champ facultatif à l'envoi.

Envoyer un sticker

Définissez sticker.url ; il n'y a rien d'autre à ajouter :
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 n'a pas de champ caption, et animated n'est pas un champ que vous définissez à l'envoi ; Bird ne le renvoie que sur un sticker entrant. from est obligatoire sur chaque message de service : un numéro appartenant à votre espace de travail, pas un numéro géré par Bird.

Limites

ChampLimiteAppliquée par
Taille, statique100 KoWhatsApp uniquement, à la récupération (async)
Taille, animé500 KoWhatsApp uniquement, à la récupération (async)
Type de fichierWebP uniquementWhatsApp uniquement, à la récupération (async)
captionchamp non valideBird, à l'acceptation (422, rejet de schéma)
urlabsolue, https, a un hôte, pas d'espace brutBird, à l'acceptation (422)
Bird vérifie la forme de l'URL avant toute mise en file d'attente ; il ne vérifie pas la taille réelle du fichier, son format, ni s'il est statique ou animé. Seule la récupération propre à WhatsApp au moment de l'envoi le peut. Envoyer un caption n'est pas une erreur de longueur ; le champ n'existe pas dans le schéma de ce type, donc il échoue en tant que propriété non reconnue. Voir dans le hub envoyer des médias par URL et quand un média échoue.

Lire un sticker entrant

Un sticker entrant contient un id, un mime_type et un animated que Bird a déterminés en récupérant le fichier. Ces trois valeurs sont absentes lors de la relecture d'un message sortant, car Bird n'a jamais récupéré ni inspecté le fichier envoyé. Voir Recevoir des stickers WhatsApp pour la lecture entrante complète, le payload whatsapp.received et les points à surveiller.

Limites et modes d'échec

  • La fenêtre de service client doit être ouverte. Les stickers sont des messages de service, livrables uniquement dans une fenêtre ouverte ; voir dans le hub la fenêtre de service client.
  • Bird rejette http ; WhatsApp lui-même le récupérerait. Voir dans le hub envoyer des médias par URL pour la vérification complète de la forme.
  • Une récupération rejetée est quand même facturée. Voir dans le hub quand un média échoue. Le texte de rejet propre aux stickers de WhatsApp n'a pas été mesuré indépendamment ; considérez la correspondance comme déduite par symétrie plutôt que confirmée par cause.
  • animated est en lecture seule et n'est présent que sur un sticker entrant ou récupéré. C'est le verdict propre à WhatsApp sur le fichier, pas quelque chose que vous pouvez déclarer. Qu'un sticker soit statique ou animé ne change que son plafond de taille ; le format WebP est requis dans les deux cas.
  • WhatsApp met en cache une URL récupérée pendant environ 10 minutes. Renvoyer la même URL dans cet intervalle resert la première récupération ; modifiez l'URL pour en forcer une nouvelle.

Étapes suivantes