Templates d'authentification WhatsApp

Avant d'envoyer

Envoyer un code de vérification

const msg = await bird.whatsapp.send({
  to: "+14155550100",
  template: {
    slug: "bird_otp",
    language: "en",
    components: [{ type: "body", parameters: [{ type: "text", text: "481920" }] }],
  },
});
console.log(msg.id, msg.status);

msg = client.whatsapp.send(
    to="+14155550100",
    template="bird_otp",
    language="en",
    components=[{"type": "body", "parameters": [{"type": "text", "text": "481920"}]}],
)
print(msg.id, msg.status)

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}
	code := "481920"
	components := []bird.WhatsAppMessageTemplateComponent{{
		Type:       "body",
		Parameters: &[]bird.WhatsAppMessageTemplateComponentParameter{{Type: "text", Text: &code}},
	}}
	msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
		To:       "+14155550100",
		Template: "bird_otp",
		Language: "en",
		Components: components,
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$components = [
    (new WhatsAppMessageTemplateComponent())
        ->setType('body')
        ->setParameters([
            (new WhatsAppMessageTemplateComponentParameter())->setType('text')->setText('481920'),
        ]),
];
$message = $bird->whatsapp->send(
    to: '+14155550100',
    template: 'bird_otp',
    language: 'en',
    components: $components,
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --components '[{"parameters":[{"text":"481920","type":"text"}],"type":"body"}]' \
  --language en \
  --template bird_otp \
  --to +14155550100

{
  "name": "whatsapp_send",
  "arguments": {
    "template": {
      "components": [
        {
          "parameters": [
            {
              "text": "481920",
              "type": "text"
            }
          ],
          "type": "body"
        }
      ],
      "language": "en",
      "slug": "bird_otp"
    },
    "to": "+14155550100"
  }
}

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "to": "+14155550100",
      "template": {
        "slug": "bird_otp",
        "language": "en",
        "components": [
          {
            "type": "body",
            "parameters": [
              {
                "type": "text",
                "text": "481920"
              }
            ]
          }
        ]
      }
    }'

• Omettez from. Un template géré par Bird choisit lui-même son expéditeur, en fonction de la catégorie et de la région ; définir from renvoie donc 422 E15018 WhatsAppSenderNotAllowed. C'est l'inverse d'un envoi libre, qui exige from, un point à retenir si vous arrivez ici depuis les pages de messages interactifs.
• to doit être un numéro de téléphone E.164. Un template d'authentification ne peut pas être envoyé à un identifiant utilisateur à portée d'entreprise ; c'est 422 E15014 WhatsAppRecipientNotSupportedForTemplate.
• Le corps prend exactement un paramètre positionnel, le code. Zéro paramètre, ou un paramètre nommé, renvoie 422 E15003 WhatsAppTemplateParameterMismatch. L'authentification est la seule catégorie que Meta écrit de façon positionnelle ; toutes les autres nomment leurs paramètres.
• Aucune fenêtre de service client n'est requise. Les envois de templates ne dépendent pas d'une fenêtre, et c'est précisément la raison d'être d'un template de code de vérification : il doit pouvoir atteindre quelqu'un qui ne vous a jamais écrit.

Le bouton de copie du code

{ "type": "button", "parameters": [{ "type": "text", "text": "481920" }] }

Ce que Meta autorise dans un template d'authentification

Coût

Points de vigilance

• Les templates fournis par Bird ne sont pas livrés vers neuf pays. bird_otp et bird_otp_authifly envoient depuis les WhatsApp Business Accounts propres à Bird, et ces comptes ne transmettent pas de messages d'authentification vers l'Égypte, l'Inde, l'Indonésie, la Malaisie, le Nigéria, le Pakistan, l'Arabie saoudite, l'Afrique du Sud et les Émirats arabes unis. Un tel envoi est refusé 422 E15063 WhatsAppDestinationRestricted avant toute facturation. Un template que vous avez créé sur votre propre compte, envoyé depuis votre propre numéro, atteint ces pays normalement. Verify les atteint aussi, en basculant automatiquement le code de vérification vers un autre canal.
• Un envoi avec template créé par vous exige from, et celui-ci doit résider sur le même WhatsApp Business Account que le template. Un expéditeur sur un compte différent est refusé 422 E15023 WhatsAppSenderWABAMismatch avant toute facturation.
• Seule une langue dont la version est approuvée et active peut être envoyée. Une langue en brouillon, en attente, rejetée ou suspendue ne l'est pas.
• Meta peut recatégoriser un template de sa propre initiative. Il n'est pas possible de s'y opposer, et cela modifie les règles de tarification et de livraison liées à la catégorie.
• La catégorie du template et celle de sa langue peuvent diverger. Consultez Templates WhatsApp pour comprendre comment le chemin d'envoi résout cette divergence.
• Un template d'authentification ingéré ne peut pas être dupliqué. Bird ne peut pas relire le texte généré par WhatsApp pour en extraire les paramètres de création d'un nouveau template ; c'est 422 E15024 WhatsAppTemplateContentNotDuplicable. Créez-en un nouveau avec sa propre recommandation de sécurité et son propre délai d'expiration du code.

Étapes suivantes

• Templates WhatsApp : parcourir le catalogue et le contrat d'envoi par template partagé
• Templates utilitaires : mises à jour de commandes, rappels de rendez-vous et notifications de compte
• Vérification d'entreprise WhatsApp : fonctionnement de la vérification et autres fonctionnalités débloquées