WhatsApp-authenticatietemplates

Voordat je verstuurt

Een verificatiecode versturen

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

• Laat from weg. Een door Bird beheerde template kiest zijn eigen afzender op basis van categorie en regio, dus het instellen van from retourneert 422 E15018 WhatsAppSenderNotAllowed. Dat is het tegenovergestelde van een verzending met vrij geformuleerde inhoud, die from vereist. Goed om te onthouden als je hier via de pagina's over interactieve berichten terechtkomt.
• to moet een E.164-telefoonnummer zijn. Een authenticatietemplate kan niet naar een business-scoped user-ID gestuurd worden; dat is 422 E15014 WhatsAppRecipientNotSupportedForTemplate.
• De body neemt precies één positionele parameter: de code. Nul parameters, of de parameter benoemen, retourneert 422 E15003 WhatsAppTemplateParameterMismatch. Authenticatie is de enige categorie die Meta positioneel schrijft; elke andere categorie benoemt zijn parameters.
• Er is geen klantenservicevenster nodig. Templateverzendingen zijn niet venstergebonden, en dat is precies de reden dat een verificatiecodetemplate bestaat: het moet iemand bereiken die je nog nooit een bericht heeft gestuurd.

De kopieerknop

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

Wat Meta toestaat in een authenticatietemplate

Kosten

Aandachtspunten

• De standaardtemplates van Bird worden niet bezorgd in negen landen. bird_otp en bird_otp_authifly versturen vanaf de eigen WhatsApp Business Accounts van Bird, en die accounts bezorgen geen authenticatieberichten in Egypte, India, Indonesië, Maleisië, Nigeria, Pakistan, Saudi-Arabië, Zuid-Afrika of de Verenigde Arabische Emiraten. Zo'n verzending wordt geweigerd met 422 E15063 WhatsAppDestinationRestricted voordat er iets in rekening wordt gebracht. Een template die je op je eigen account hebt aangemaakt en vanaf je eigen nummer verstuurt, bereikt deze landen gewoon. Verify bereikt ze ook, door de verificatiecode zelfstandig naar een ander kanaal te verplaatsen.
• Een verzending met een eigen template vereist from, en die moet op hetzelfde WhatsApp Business Account staan als de template. Een afzender op een ander account wordt geweigerd met 422 E15023 WhatsAppSenderWABAMismatch voordat er iets in rekening wordt gebracht.
• Alleen een taalversie die goedgekeurd en live is, kan verstuurd worden. Een concept-, in behandeling zijnde, afgewezen of gepauzeerde taalversie niet.
• Meta kan een template op eigen initiatief hercategoriseren. Er is geen opt-out, en het verplaatst de prijs- en bezorgregels die bij de categorie horen.
• De categorie van de template en de categorie van de taalversie kunnen uiteenlopen. Zie WhatsApp-templates voor hoe het verzendpad dit oplost.
• Een geïmporteerde authenticatietemplate kan niet gedupliceerd worden. Bird kan de door WhatsApp gegenereerde tekst niet teruglezen naar de instellingen waaruit een nieuwe template wordt opgebouwd; dat is 422 E15024 WhatsAppTemplateContentNotDuplicable. Maak in plaats daarvan een nieuwe aan met een eigen beveiligingsaanbeveling en codeverlooptijd.

Volgende stappen

• WhatsApp-templates: de catalogus doorzoeken en het gedeelde send-by-template-contract
• Utility-templates: orderupdates, afspraakherinneringen en accountmeldingen
• WhatsApp-bedrijfsverificatie: hoe verificatie werkt en wat het verder ontgrendelt