# Templates utilitaires WhatsApp Un template utilitaire fait suite à une action déjà effectuée par le destinataire : une commande, un paiement, une réservation, une connexion. Le catalogue de Bird en propose huit, dont `bird_signin_alert` et `bird_delivery_update`. Prenez la catégorie d'un slug dans la liste des templates plutôt que dans son nom : `bird_signin_alert` ressemble à un template d'authentification mais n'en est pas un, c'est un template utilitaire. ## Avant d'envoyer Choisissez un modèle du catalogue géré ou créez le vôtre sur votre compte professionnel connecté. L'envoi des templates du catalogue de Bird ne nécessite aucune vérification de votre part, comme pour l'authentification. Créer votre propre template utilitaire n'en nécessite pas non plus : contrairement à l'authentification, la vérification d'entreprise imposée par Meta ne s'applique jamais à la catégorie utilitaire, vous pouvez donc créer et modifier des templates utilitaires sur un espace de travail non vérifié. Consultez [Vérification d'entreprise WhatsApp](/docs/knowledge-base/whatsapp/business-verification) pour savoir ce que la vérification débloque par ailleurs. `to` peut être un numéro de téléphone E.164 ou un identifiant utilisateur limité à l'entreprise. Un template utilitaire ne comporte pas de bouton OTP, il n'exige donc pas le destinataire au format numéro de téléphone uniquement qu'impose l'authentification. Chaque template utilitaire du catalogue géré est enregistré dans `en` uniquement, avec `on_missing_language: fail`. Demander une langue absente du catalogue fait échouer l'envoi au lieu de basculer vers l'anglais ou toute autre langue. ## Envoyer un template utilitaire `POST /v1/whatsapp/messages` avec un objet `template` désignant un slug du catalogue : **TypeScript** ```typescript const msg = await bird.whatsapp.send({ to: "+16505551234", template: { slug: "bird_order_confirmation", language: "en", components: [ { type: "body", parameters: [ { type: "text", name: "ref", text: "A1B2C3D4" }, { type: "text", name: "amount", text: "USD 49.99" }, ], }, ], }, }); console.log(msg.id, msg.status); ``` Examples: [TypeScript](/fr-fr/documentation/guides/whatsapp/templates/utility.ts.md) · [Python](/fr-fr/documentation/guides/whatsapp/templates/utility.py.md) · [Go](/fr-fr/documentation/guides/whatsapp/templates/utility.go.md) · [PHP](/fr-fr/documentation/guides/whatsapp/templates/utility.php.md) · [CLI](/fr-fr/documentation/guides/whatsapp/templates/utility.cli.md) · [MCP](/fr-fr/documentation/guides/whatsapp/templates/utility.mcp.md) · [cURL](/fr-fr/documentation/guides/whatsapp/templates/utility.curl.md) Comme pour tout template géré, omettez `from` : Bird choisit le numéro d'envoi en fonction de la catégorie et de la région, et le définir renvoie `422` [`E15018`](/docs/api/errors/E15018) `WhatsAppSenderNotAllowed`. Créer votre propre template utilitaire et l'envoyer fonctionne de la même manière que tout envoi avec un template créé par vous ; consultez [Envoyer avec un template](/docs/guides/whatsapp/templates#sending-with-a-template) pour le contrat général. ## Remplir les variables Les paramètres utilitaires sont nommés, l'inverse du code positionnel unique de l'authentification. Chaque paramètre porte un `name`, et l'ordre d'un paramètre nommé dans le tableau n'a aucune importance. Envoyez une entrée `components` pour chaque bloc qui contient effectivement un espace réservé ; un corps sans variables ne prend aucune entrée `components`. Un bouton URL est la seule exception : sa variable est toujours positionnelle `{{1}}`, et l'envoi transporte la valeur brute plutôt qu'une adresse complète : ```json { "type": "button", "parameters": [{ "type": "text", "text": "A-4192" }] } ``` Pour les règles partagées sur les composants, `sub_type`, et la correspondance entre les `components` d'un envoi et les espaces réservés déclarés d'un template, consultez [Envoyer avec un template](/docs/guides/whatsapp/templates#sending-with-a-template) et [Composants et paramètres](/docs/guides/whatsapp/sending-whatsapp#components-and-parameters). ## Coût Un modèle utilitaire livré pendant une fenêtre de service client ouverte peut bénéficier du tarif gratuit de Meta. Les frais sortants de Bird sont facturés lors du traitement du message, avant la soumission. Un callback ultérieur de livraison ou de lecture détermine si des frais Meta s'appliquent. Tenez compte des deux composantes pour estimer le total. Consultez [Coûts et facturation](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing) pour savoir quand un envoi est facturé, et [Tarification WhatsApp](/products/whatsapp/pricing) pour les tarifs. ## Points de vigilance - **Meta peut recatégoriser un template utilitaire en marketing de sa propre initiative**, et le message continue d'être envoyé au nouveau tarif, plus élevé. Une entreprise déjà avertie par Meta pour mauvaise catégorisation ne reçoit plus aucun préavis depuis avril 2025 ; le changement s'applique immédiatement. Excluez le langage promotionnel, les offres et les ventes additionnelles du texte d'un template utilitaire, car c'est ce qui déclenche le reclassement. Consultez [Directives pour les templates](/docs/knowledge-base/whatsapp/template-guidelines) pour savoir ce qui est considéré comme promotionnel. - **Un en-tête `gif` ou un bouton `copy_code` est refusé en dehors de la catégorie marketing.** Ce sont des composants réservés au marketing ; déclarer l'un ou l'autre sur un template utilitaire échoue. - **Un envoi avec un template créé par vous n'est pas vérifié pour le nombre de paramètres avant d'être facturé.** Envoyez un nombre incorrect de paramètres sur votre propre template et le message est accepté et facturé, puis rejeté par Meta. Les envois via le catalogue géré ne présentent pas ce problème. - **Un expéditeur sur le mauvais WhatsApp Business Account est refusé avant toute facturation.** `from` doit se trouver sur le même compte que le template ; sinon l'envoi échoue `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch`. ## Étapes suivantes - [Templates WhatsApp](/docs/guides/whatsapp/templates) : parcourir le catalogue et le contrat partagé d'envoi par template - [Templates d'authentification](/docs/guides/whatsapp/templates/authentication) : codes de vérification à usage unique et vérification requise pour en créer un - [Templates marketing](/docs/guides/whatsapp/templates/marketing) : envois promotionnels et le compte nécessaire pour en créer un ## Related resources - [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video) - [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer) - [WhatsApp message builder](/tools/whatsapp-message-builder) (tool) - [WhatsApp](/products/whatsapp) (product) [Get an implementation brief](/learn/workspace?topic=whatsapp)