Template di autenticazione WhatsApp

Prima di inviare

Inviare un codice di verifica

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

• Ometti from. Un template gestito da Bird sceglie il proprio mittente in base alla categoria e alla regione, quindi impostare from restituisce 422 E15018 WhatsAppSenderNotAllowed. È l'opposto di un invio libero, che richiede from: vale la pena ricordarlo se arrivi dalle pagine sui messaggi interattivi.
• to deve essere un numero di telefono E.164. Un template di autenticazione non può essere inviato a un ID utente con ambito aziendale: restituisce 422 E15014 WhatsAppRecipientNotSupportedForTemplate.
• Il corpo accetta esattamente un parametro posizionale, il codice. Zero parametri, o un parametro con nome, restituisce 422 E15003 WhatsAppTemplateParameterMismatch. L'autenticazione è l'unica categoria in cui Meta usa parametri posizionali; tutte le altre usano parametri con nome.
• Non serve una finestra di assistenza clienti. Gli invii tramite template non richiedono una finestra aperta, ed è proprio il motivo per cui esiste un template per codici di verifica: deve raggiungere qualcuno che non ti ha mai scritto.

Il pulsante copia codice

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

Cosa consente Meta in un template di autenticazione

Costi

Aspetti da tenere d'occhio

• I template preconfigurati di Bird non consegnano verso nove paesi. bird_otp e bird_otp_authifly inviano dai WhatsApp Business Account di Bird, e quegli account non trasportano messaggi di autenticazione verso Egitto, India, Indonesia, Malesia, Nigeria, Pakistan, Arabia Saudita, Sudafrica o Emirati Arabi Uniti. Un invio di questo tipo viene rifiutato 422 E15063 WhatsAppDestinationRestricted prima che venga addebitato qualsiasi costo. Un template creato sul tuo account e inviato dal tuo numero raggiunge questi paesi normalmente. Verify li raggiunge ugualmente, spostando il codice di verifica su un altro canale in autonomia.
• Un invio con template creato da te richiede from, che deve trovarsi sullo stesso WhatsApp Business Account del template. Un mittente su un account diverso viene rifiutato 422 E15023 WhatsAppSenderWABAMismatch prima che venga addebitato qualsiasi costo.
• Solo una lingua la cui versione è approvata e attiva può essere inviata. Una lingua in bozza, in attesa, rifiutata o sospesa non può esserlo.
• Meta può ricategorizzare un template di propria iniziativa. Non è possibile rifiutare, e la modifica sposta le regole di prezzo e consegna legate alla categoria.
• La categoria del template e la categoria della sua lingua possono divergere. Consulta Template WhatsApp per capire come il percorso di invio risolve questa situazione.
• Un template di autenticazione importato non può essere duplicato. Bird non è in grado di rileggere il testo generato da WhatsApp per ricavarne le impostazioni da cui costruire un nuovo template: restituisce 422 E15024 WhatsAppTemplateContentNotDuplicable. Creane uno nuovo con la propria raccomandazione di sicurezza e la propria scadenza del codice.

Passaggi successivi

• Template WhatsApp: esplorazione del catalogo e contratto condiviso di invio tramite template
• Template utility: aggiornamenti sugli ordini, promemoria per appuntamenti e avvisi sull'account
• Verifica aziendale WhatsApp: come funziona la verifica e cos'altro sblocca