Pesan video WhatsApp
Pesan video membawa URL publik yang diambil WhatsApp pada saat pengiriman, dengan caption opsional di bawahnya.
Mengirim video
Atur video.url:
const msg = await bird.whatsapp.send({
to: "+16505551234",
from: "+13124495648",
video: { url: "https://cdn.example.com/unboxing.mp4" },
});
console.log(msg.id, msg.status);msg = client.whatsapp.send(
to="+16505551234",
from_="+13124495648",
video={"url": "https://cdn.example.com/unboxing.mp4"},
)
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)
}
msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
To: "+16505551234",
From: "+13124495648",
Video: &bird.WhatsAppVideoSend{Url: "https://cdn.example.com/unboxing.mp4"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$video = (new WhatsAppMessageSendRequestVideo())
->setUrl('https://cdn.example.com/unboxing.mp4');
$message = $bird->whatsapp->send(
to: '+16505551234',
from: '+13124495648',
video: $video,
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--from +13124495648 \
--to +16505551234 \
--video https://cdn.example.com/unboxing.mp4{
"name": "whatsapp_send",
"arguments": {
"from": "+13124495648",
"to": "+16505551234",
"video": {
"url": "https://cdn.example.com/unboxing.mp4"
}
}
}curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+16505551234",
"from": "+13124495648",
"video": {
"url": "https://cdn.example.com/unboxing.mp4"
}
}'Bentuk lengkapnya menambahkan caption opsional:
Contoh kode
{
"to": "+16505551234",
"from": "+13124495648",
"video": {
"url": "https://cdn.example.com/unboxing.mp4",
"caption": "How to set it up"
}
}video tidak memiliki field filename. from wajib ada di setiap pesan layanan: nomor yang dimiliki workspace Anda, bukan nomor yang dikelola Bird.
Batas
| Field | Batas | Diterapkan oleh |
|---|---|---|
| Ukuran file | 16 MB | Hanya WhatsApp, saat fetch (async) |
| Format | Kontainer MP4, video H.264, audio AAC | Hanya WhatsApp, saat fetch (async) |
| caption | hingga 1.024 karakter | Bird, saat accept (422) |
| url | absolut, https, memiliki host, tanpa spasi mentah | Bird, saat accept (422) |
Bird memeriksa bentuk URL dan panjang caption sebelum apa pun masuk antrean. Pemeriksaan ini tidak mencakup ukuran file, kontainer, atau codec yang sebenarnya; hanya fetch WhatsApp sendiri pada saat pengiriman yang bisa. Lihat mengirim media melalui URL dan saat media gagal di hub.
Membaca video masuk
Video masuk membawa objek video yang sama, ditambah id dan mime_type yang dipelajari Bird dengan mengambil file tersebut. Keduanya tidak ada pada pembacaan ulang pesan keluar, karena Bird tidak pernah mengambil file yang dikirimnya. Lihat Menerima video WhatsApp untuk pembacaan masuk selengkapnya, payload whatsapp.received, dan hal-hal yang perlu diperhatikan.
Batas dan mode kegagalan
- Jendela layanan pelanggan harus terbuka. Video adalah pesan layanan, hanya dapat dikirim di dalam jendela yang terbuka; lihat jendela layanan pelanggan di hub.
- Bird menolak http; WhatsApp sendiri yang akan mengambilnya. Lihat mengirim media melalui URL di hub untuk pemeriksaan bentuk selengkapnya.
- Fetch yang ditolak tetap dikenakan biaya. Lihat saat media gagal di hub untuk media_rejected dan fakta pengenaan biaya saat gagal. Teks penolakan video dari WhatsApp belum diukur secara independen seperti halnya gambar, jadi perlakukan pemetaan ini sebagai kesimpulan berdasarkan kesamaan pola, bukan dikonfirmasi per penyebab.
- WhatsApp meng-cache URL yang diambil selama sekitar 10 menit. Mengirim ulang URL yang sama dalam jendela tersebut akan menyajikan kembali hasil fetch pertama; ubah URL untuk memaksa pengambilan baru.
- GIF animasi bukan tipe tersendiri. WhatsApp tidak memiliki tipe pesan gif; GIF animasi yang Anda kirim sampai ke penerima, dan akan kembali kepada Anda sebagai pesan masuk, sebagai video biasa dengan tipe MIME MP4.
Langkah selanjutnya
- Pesan layanan WhatsApp: jendela layanan pelanggan dan model yang digunakan bersama oleh setiap pesan layanan
- Gambar: bentuk yang sama untuk foto atau grafik
- Audio: untuk catatan suara atau klip audio
- Mengirim pesan WhatsApp: envelope permintaan, model 202, dan percobaan ulang yang aman
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Tonton panduannyaConnecting WhatsApp to Bird: from buying a number to a live channelPahami konsepnyaWhat is the 24-hour customer service window on WhatsApp?Gunakan alatnyaWhatsApp message builderJelajahi kemampuannyaWhatsApp
Coba praktiknya dan dapatkan ringkasan implementasi