Template autentikasi WhatsApp

Sebelum Anda mengirim

Mengirim kode verifikasi

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

• Jangan sertakan from. Template yang dikelola Bird memilih pengirimnya sendiri berdasarkan kategori dan wilayah, sehingga menyetel from menghasilkan 422 E15018 WhatsAppSenderNotAllowed. Ini kebalikan dari pengiriman bebas yang memerlukan from, penting diingat jika Anda datang dari halaman pesan interaktif.
• to harus berupa nomor telepon E.164. Template autentikasi tidak dapat dikirim ke ID pengguna cakupan bisnis; itu menghasilkan 422 E15014 WhatsAppRecipientNotSupportedForTemplate.
• Body menerima tepat satu parameter posisional, yaitu kode. Tanpa parameter, atau menamai parameter, menghasilkan 422 E15003 WhatsAppTemplateParameterMismatch. Autentikasi adalah satu-satunya kategori yang ditulis Meta secara posisional; semua kategori lain menamai parameternya.
• Tidak perlu jendela layanan pelanggan. Pengiriman template tidak dibatasi jendela, dan itulah alasan template kode verifikasi ada: template harus bisa menjangkau seseorang yang belum pernah mengirim pesan kepada Anda.

Tombol salin kode

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

Apa yang Meta izinkan dalam template autentikasi

Biaya

Hal yang perlu diperhatikan

• Template bawaan Bird tidak mengirim ke sembilan negara. bird_otp dan bird_otp_authifly mengirim dari WhatsApp Business Account milik Bird sendiri, dan akun tersebut tidak mengirimkan pesan autentikasi ke Mesir, India, Indonesia, Malaysia, Nigeria, Pakistan, Arab Saudi, Afrika Selatan, atau Uni Emirat Arab. Pengiriman semacam itu ditolak 422 E15063 WhatsAppDestinationRestricted sebelum dikenakan biaya. Template yang Anda buat di akun sendiri, dikirim dari nomor Anda sendiri, menjangkau negara-negara ini secara normal. Verify juga menjangkau mereka, dengan memindahkan kode verifikasi ke kanal lain secara otomatis.
• Pengiriman template buatan sendiri memerlukan from, dan nomor pengirim harus berada di WhatsApp Business Account yang sama dengan template. Pengirim dari akun berbeda ditolak 422 E15023 WhatsAppSenderWABAMismatch sebelum dikenakan biaya.
• Hanya bahasa yang versinya disetujui dan aktif yang dapat dikirim. Bahasa berstatus draf, pending, ditolak, atau dijeda tidak dapat dikirim.
• Meta dapat mengubah kategori template atas inisiatifnya sendiri. Tidak ada opsi menolak, dan perubahan kategori ini turut mengubah aturan harga dan pengiriman yang berlaku.
• Kategori template dan kategori bahasanya bisa berbeda. Lihat Template WhatsApp untuk cara jalur pengiriman menyelesaikan hal ini.
• Template autentikasi yang sudah diimpor tidak dapat diduplikasi. Bird tidak dapat membaca kembali teks yang dibuat WhatsApp lalu mengubahnya kembali menjadi pengaturan untuk membuat template baru; itu menghasilkan 422 E15024 WhatsAppTemplateContentNotDuplicable. Buat template baru dengan rekomendasi keamanan dan kedaluwarsa kode tersendiri.

Langkah selanjutnya

• Template WhatsApp: menelusuri katalog dan kontrak pengiriman berdasarkan template yang digunakan bersama
• Template utility: pembaruan pesanan, pengingat janji temu, dan pemberitahuan akun
• Verifikasi bisnis WhatsApp: cara kerja verifikasi dan apa lagi yang dibukanya