Lewati ke konten utama

Sesi Provider (WAHA dan Channel Lain)

Setiap channel percakapan di Custelio berjalan di atas sesi atau integrasi provider. Halaman ini memetakan jenis provider yang tersedia serta kondisi konfigurasinya, dan menjelaskan alur kerja serta batas yang berlaku. Kontrak payload mengikuti OpenAPI runtime, bukan halaman ini.

Tujuan​

Admin menentukan provider mana yang bisa dipakai tenant-nya, prasyarat konfigurasinya, dan status jujur setiap channel — termasuk channel yang menjawab 501 karena belum dikonfigurasi atau tidak didukung.

Untuk siapa​

Account owner dan admin yang mengelola pengaturan integrasi dan channel.

Prasyarat​

  • WAHA sebagai gateway utama: konfigurasi lengkap ada di Sesi Provider WAHA.
  • Untuk channel lain, sediakan kredensial provider (token bot, channel secret/access token) dan simpan dengan aman.
  • Inbox tujuan sudah ada sebelum sesi/channel dikaitkan.

Peta provider​

WhatsApp melalui WAHA (utama)​

Dikonfigurasi admin, terhubung lewat QR, dan wajib terbukti mampu mengirim sebelum dipakai untuk percakapan nyata. Lihat Sesi Provider WAHA. Channel non-WAHA bersifat eksperimental sampai readinessnya dibuktikan.

Meta, Instagram, Facebook, email, SMS​

Receiver inbound terdaftar di runtime dan diverifikasi dengan secret/challenge masing-masing. Ketersediaannya di deployment bergantung konfigurasi environment; periksa status pada deployment Anda.

Telegram dan LINE (kondisional)​

Telegram (TELEGRAM_BOT_TOKEN, TELEGRAM_CHANNEL_SECRET) dan LINE (LINE_CHANNEL_SECRET, LINE_CHANNEL_ACCESS_TOKEN) hanya aktif bila client dikonfigurasi. Bila kredensial tidak ada, webhook channel menjawab 501 Not Implemented dengan pesan "not configured" — itu kondisi jujur, bukan error yang boleh disembunyikan.

  1. Sediakan kredensial provider dan secret channel pada environment/secret manager.
  2. Konfigurasikan webhook URL deployment ke provider (URL publik HTTPS).
  3. Verifikasi challenge/secret di sisi provider, lalu kirim pesan uji.
  4. Pantau event inbound dan status. Jangan klaim channel tersedia bila konfigurasinya tidak ada.

TikTok (tidak didukung)​

TikTok tidak didukung sebagai channel percakapan umum. Webhook TikTok selalu menjawab 501 dengan keterangan bahwa TikTok tidak menyediakan general-purpose messaging API; hanya buyer-seller messaging dalam konteks order TikTok Shop yang tersedia di luar produk. Jangan mengonfigurasi TikTok sebagai channel yang bisa dibalas agen.

Tanda berhasil​

Setiap channel yang dipakai punya konfigurasi eksplisit, terverifikasi dengan pesan uji, dan menampilkan status nyata. Channel yang tidak dikonfigurasi atau tidak didukung menjawab 501 tanpa disamarkan sebagai tersedia.

Jika terjadi masalah​

  • 501 not configured: kredensial channel belum diatur; tambahkan environment yang benar, lalu mulai ulang service.
  • 501 tiktok not supported: TikTok memang tidak didukung; jangan membangun alur yang membalas pesan di atasnya.
  • Challenge/secret ditolak: periksa secret channel dan URL webhook publik; jangan menonaktifkan verifikasi.
  • Pesan tidak sampai: perlakukan sebagai kegagalan delivery; periksa dispatcher, webhook, dan status provider.

Batasan​

Status sesi/channel tidak menjamin pesan terkirim: verifikasi delivery aktual dan health. Channel non-WAHA tetap eksperimental sampai core WAHA stabil dan readinessnya dibuktikan. Endpoint dan payload mengikuti OpenAPI runtime; halaman ini tidak menduplikasi skema.

Tugas terkait​