Szablony uwierzytelniania WhatsApp

Zanim wyślesz

Wysyłanie kodu weryfikacyjnego

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

• Pomiń from. Szablon zarządzany przez Bird sam wybiera nadawcę na podstawie kategorii i regionu, więc ustawienie from zwraca 422 E15018 WhatsAppSenderNotAllowed. To odwrotność wysyłki swobodnej, która wymaga from, co warto zapamiętać, jeśli przechodzisz tu ze stron wiadomości interaktywnych.
• to musi być numerem telefonu w formacie E.164. Szablon uwierzytelniania nie może być wysłany do identyfikatora użytkownika w zakresie firmy; to 422 E15014 WhatsAppRecipientNotSupportedForTemplate.
• Treść przyjmuje dokładnie jeden parametr pozycyjny, czyli kod. Zero parametrów lub nazwany parametr zwraca 422 E15003 WhatsAppTemplateParameterMismatch. Uwierzytelnianie to jedyna kategoria, w której Meta stosuje parametry pozycyjne; każda inna kategoria używa parametrów nazwanych.
• Okno obsługi klienta nie jest wymagane. Wysyłki szablonów nie podlegają ograniczeniu okna, i właśnie dlatego szablon kodu weryfikacyjnego istnieje: musi dotrzeć do kogoś, kto nigdy wcześniej do Ciebie nie napisał.

Przycisk kopiowania kodu

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

Co Meta dopuszcza w szablonie uwierzytelniania

Koszt

Na co uważać

• Gotowe szablony Bird nie docierają do dziewięciu krajów. bird_otp i bird_otp_authifly wysyłają z własnych kont WhatsApp Business Accounts należących do Bird, a te konta nie dostarczają wiadomości uwierzytelniających do Egiptu, Indii, Indonezji, Malezji, Nigerii, Pakistanu, Arabii Saudyjskiej, Republiki Południowej Afryki ani Zjednoczonych Emiratów Arabskich. Taka wysyłka jest odrzucana 422 E15063 WhatsAppDestinationRestricted zanim cokolwiek zostanie naliczone. Szablon, który sam stworzyłeś na swoim koncie i wysyłasz ze swojego numeru, dociera do tych krajów normalnie. Verify też do nich dociera, samodzielnie przenosząc kod weryfikacyjny na inny kanał.
• Wysyłka własnego szablonu wymaga from, który musi należeć do tego samego konta WhatsApp Business Account co szablon. Nadawca z innego konta jest odrzucany 422 E15023 WhatsAppSenderWABAMismatch zanim cokolwiek zostanie naliczone.
• Można wysłać tylko wersję językową, która jest zatwierdzona i aktywna. Wersja w stanie roboczym, oczekująca, odrzucona lub wstrzymana nie nadaje się do wysyłki.
• Meta może samodzielnie zmienić kategorię szablonu. Nie ma możliwości rezygnacji, a zmiana przenosi reguły cenowe i dostarczania powiązane z kategorią.
• Kategoria szablonu i kategoria jego wersji językowej mogą się różnić. Zobacz Szablony WhatsApp, żeby dowiedzieć się, jak ścieżka wysyłki to rozwiązuje.
• Zaimportowanego szablonu uwierzytelniania nie można zduplikować. Bird nie potrafi odczytać wygenerowanej treści WhatsApp z powrotem do ustawień, z których budowany jest nowy szablon; to 422 E15024 WhatsAppTemplateContentNotDuplicable. Zamiast tego utwórz nowy szablon z własną rekomendacją bezpieczeństwa i czasem wygaśnięcia kodu.

Następne kroki

• Szablony WhatsApp: przeglądanie katalogu i wspólny kontrakt wysyłki przez szablon
• Szablony utility: aktualizacje zamówień, przypomnienia o wizytach i powiadomienia o koncie
• Weryfikacja firmy WhatsApp: jak działa weryfikacja i co jeszcze odblokowuje