WhatsApp-Authentifizierungstemplates

Bevor Sie senden

Einen Bestätigungscode senden

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"
              }
            ]
          }
        ]
      }
    }'

• Lassen Sie from weg. Ein von Bird verwaltetes Template wählt seinen Absender selbst, anhand von Kategorie und Region. Das Setzen von from gibt 422 E15018 WhatsAppSenderNotAllowed zurück. Das ist das Gegenteil eines Freitextversands, der from erfordert; wichtig zu wissen, wenn Sie von den Seiten zu interaktiven Nachrichten kommen.
• to muss eine E.164-Telefonnummer sein. Ein Authentifizierungstemplate kann nicht an eine unternehmensspezifische Benutzer-ID gesendet werden; das ergibt 422 E15014 WhatsAppRecipientNotSupportedForTemplate.
• Der Body akzeptiert genau einen positionellen Parameter: den Code. Null Parameter oder ein benannter Parameter gibt 422 E15003 WhatsAppTemplateParameterMismatch zurück. Authentifizierung ist die einzige Kategorie, die Meta positionell schreibt; jede andere Kategorie benennt ihre Parameter.
• Kein Kundenservice-Fenster erforderlich. Template-Versendungen sind nicht an ein Fenster gebunden; genau deshalb gibt es Bestätigungscode-Templates: Sie müssen jemanden erreichen können, der Ihnen noch nie geschrieben hat.

Die Code-kopieren-Schaltfläche

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

Was Meta in einem Authentifizierungstemplate erlaubt

Kosten

Worauf Sie achten sollten

• Die vorgefertigten Templates von Bird werden in den folgenden neun Ländern nicht zugestellt. bird_otp und bird_otp_authifly senden über die eigenen WhatsApp Business Accounts von Bird, und diese Konten übermitteln keine Authentifizierungsnachrichten nach Ägypten, Indien, Indonesien, Malaysia, Nigeria, Pakistan, Saudi-Arabien, Südafrika oder in die Vereinigten Arabischen Emirate. Ein solcher Versand wird mit 422 E15063 WhatsAppDestinationRestricted abgelehnt, bevor etwas berechnet wird. Ein Template, das Sie auf Ihrem eigenen Konto erstellt haben und von Ihrer eigenen Nummer senden, erreicht diese Länder normal. Verify erreicht sie ebenfalls, indem es den Bestätigungscode selbstständig auf einen anderen Kanal verschiebt.
• Ein Versand mit eigenem Template erfordert from, und dieser muss auf demselben WhatsApp Business Account liegen wie das Template. Ein Absender auf einem anderen Konto wird mit 422 E15023 WhatsAppSenderWABAMismatch abgelehnt, bevor etwas berechnet wird.
• Nur eine Sprache, deren Version genehmigt und live ist, kann gesendet werden. Eine Sprache im Status Entwurf, Ausstehend, Abgelehnt oder Pausiert kann es nicht.
• Meta kann ein Template von sich aus umkategorisieren. Es gibt kein Opt-out, und die Preis- und Zustellregeln der Kategorie verschieben sich mit.
• Die Kategorie des Templates und die Kategorie seiner Sprache können voneinander abweichen. Siehe WhatsApp-Templates dazu, wie der Versandpfad dies auflöst.
• Ein eingelesenes Authentifizierungstemplate kann nicht dupliziert werden. Bird kann den von WhatsApp generierten Text nicht in die Einstellungen zurücklesen, aus denen ein neues Template erstellt wird; das ergibt 422 E15024 WhatsAppTemplateContentNotDuplicable. Erstellen Sie stattdessen ein neues Template mit eigener Sicherheitsempfehlung und Code-Ablaufzeit.

Nächste Schritte

• WhatsApp-Templates: Katalog durchsuchen und der gemeinsame Vertrag für den Versand per Template
• Utility-Templates: Bestellaktualisierungen, Terminerinnerungen und Kontobenachrichtigungen
• WhatsApp-Unternehmensverifizierung: wie die Verifizierung funktioniert und was sie sonst noch freischaltet