MasukMulai uji coba gratis
easyCoexistence API resmi

Cara membangun produk agen AI di WhatsApp, Instagram dan TikTok pelanggan Anda

Produk agen AI di saluran pelanggan bertumpu pada tiga komponen: tautan koneksi yang dihosting untuk setiap nomor WhatsApp atau akun media sosial pelanggan; webhook yang membawa pesan dan komentar mereka ke backend Anda, tempat model Anda sendiri menulis balasan yang dikirim melalui API resmi tiap jaringan dengan token pelanggan; serta event status untuk koneksi yang terputus. Agen tetap mematuhi aturan tiap jaringan, misalnya jendela 24 jam WhatsApp.

easyCoexistence memberi agen AI produk Anda suara di nomor WhatsApp pelanggan dan akun Instagram, Facebook, TikTok, YouTube serta LinkedIn mereka, dan saluran lain yang terus bertambah: tautan koneksi yang dihosting, kredensial baru, webhook, serta event status yang ditandatangani pada API resmi tiap jaringan, dengan setiap koneksi dipantau 24/7.

24 hours

Jendela layanan pelanggan WhatsApp dimulai setelah pesan atau panggilan dari pengguna; setiap pesan baru mengatur ulang jendela tersebut.

Templates only

Yang dapat dikirim bisnis WhatsApp setelah jendela layanan pelanggan ditutup: pesan template yang telah disetujui sebelumnya.

Section 4.7

Ketentuan Meta melarang penyedia AI menggunakan WhatsApp untuk menawarkan AI sebagai fungsi utama, bukan fungsi sampingan.

7 days

Jendela untuk satu balasan pribadi per komentar pada akun Instagram, dihitung sejak komentar dibuat.

20 mps

Throughput tetap untuk nomor yang digunakan bersama aplikasi WhatsApp Business dan Cloud API.

Apa yang dibutuhkan produk agen AI dari saluran setiap pelanggan?

Ada empat hal: cara bagi pelanggan untuk menghubungkannya, pesan mereka sampai ke backend Anda, token untuk membalas, dan kabar saat koneksi berhenti berfungsi. Partner API mencakup keempatnya, sementara model, prompt, dan logika percakapan tetap menjadi milik Anda. easyCoexistence menghubungkan akun, menjaga aksesnya tetap diperbarui dan memantaunya, lalu balasan Anda berjalan langsung dari backend ke API jaringan.

1ConnectA hosted link per customer: POST /connect-sessions
2ReceiveMessages from Meta; comments and DMs forwarded, signed
3DecideYour model, your prompts, your memory
4ReplyThe network's API, with the customer's token
5Watchconnection.* and channel.* status events

Bagaimana setiap pelanggan terhubung?

Backend Anda membuat sesi koneksi dengan POST /connect-sessions, dengan menyebutkan saluran, redirect_url, dan external_ref untuk pelanggan Anda, serta untuk nomor, webhook_url dan webhook_verify_token. Pelanggan membuka tautan yang dihosting, masuk dengan Meta, TikTok, Google atau LinkedIn, lalu kembali ke aplikasi Anda dengan connection_id atau channel_id. Mereka tidak memerlukan akun easyCoexistence, email, atau kartu, dan setiap koneksi yang dibuat melalui kunci Anda menjadi milik akun Anda.

Bagaimana pesan dan komentar sampai ke model Anda?

Melalui webhook, pada jaringan yang mengirimnya. Meta mengirim pesan nomor langsung ke webhook_url, dan apa yang dikirim staf bisnis dari aplikasi WhatsApp Business tiba di sana sebagai smb_message_echoes. Komentar, mention, dan DM Instagram serta Facebook, dan komentar TikTok, diteruskan ke tujuan setiap saluran, ditandatangani dengan kunci rahasianya. YouTube dan LinkedIn tidak mengirim event komentar, sehingga agen membaca komentar baru melalui API mereka sesuai jadwal. Balas setiap pengiriman dengan 2xx segera dan biarkan worker memanggil model.

Bagaimana agen membalas?

Melalui API jaringan itu sendiri, dengan kredensial yang diambil backend Anda. Balasan WhatsApp berupa POST ke send_endpoint nomor dengan token pelanggan; DM Instagram atau Facebook dikirim ke edge messages akun; balasan TikTok dikirim di bawah komentar melalui business/comment/reply/create/. Sketsa di bawah ini membalas pesan WhatsApp: ia memeriksa kunci rahasia di jalur URL, memasukkan setiap pesan masuk ke antrean, dan membalas dengan apa pun yang dikembalikan model Anda.

Python: a WhatsApp agent on your own model
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request

EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}  # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"]  # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {}  # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)

@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
    if not hmac.compare_digest(secret, PATH_SECRET):
        abort(404)
    if request.method == "GET":  # Meta's handshake when the destination is set
        if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
            abort(403)
        return request.args.get("hub.challenge", "")
    for entry in request.get_json().get("entry", []):
        for change in entry.get("changes", []):
            if change.get("field") == "messages":  # echoes and history are context, not prompts
                value = change["value"]
                for msg in value.get("messages", []):
                    jobs.put((value["metadata"]["phone_number_id"], msg))
    return "", 200  # answer at once; dedupe on msg["id"], since Meta can deliver twice

def worker() -> None:
    while True:
        phone_number_id, msg = jobs.get()
        conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
                            headers=KEY, params={"credentials": 1}).json()
        creds = conn["credentials"]
        if not creds["access_token"]:  # token_ready is false: a new connect session issues one
            continue
        reply = my_model(conn["external_ref"], msg)  # your model, your prompt, your memory
        requests.post(creds["send_endpoint"],  # a reply to a fresh message is inside the 24 hours
                      headers={"Authorization": f"Bearer {creds['access_token']}"},
                      json={"messaging_product": "whatsapp", "to": msg["from"],
                            "type": "text", "text": {"body": reply}})

threading.Thread(target=worker, daemon=True).start()

MCP server atau Partner API: mana yang digunakan agen?

Partner API, ketika agen adalah produk Anda dan pelanggan Anda yang membawa saluran: backend Anda menyimpan kunci, menerima event, dan menjalankan model apa pun yang Anda pilih. MCP server di https://easycoexistence.com/api/mcp cocok untuk asisten seperti Claude atau ChatGPT yang bekerja pada akun easyCoexistence Anda sendiri, melalui tool yang dipanggilnya atas permintaan setelah masuk dengan OAuth. Nomor dan saluran yang terhubung dengan kunci Anda juga berada di akun itu, sehingga sesi MCP dapat menjangkaunya untuk pekerjaan tim Anda sendiri.

Partner APIMCP server
Built forYour product, serving your customersAn assistant working on your own account
Signs in withAn ec_live_ key, one per accountOAuth, from Claude, ChatGPT or another client
Incoming messagesWebhooks to your backendRead when the assistant calls a tool
The modelAny model you runThe assistant's own
RepliesYour code calls each network's APITools such as send_message and reply_to_comment

Bagaimana agensi menjalankan agen untuk banyak klien?

Pada satu akun, dengan setiap klien diberi tag. Kirim ID klien sebagai external_ref pada setiap sesi koneksi, tampilkan nama agensi Anda di halaman yang dihosting dengan partner_name, dan daftar koneksi satu klien dengan GET /connections?external_ref= dan GET /channels?external_ref=. Setiap koneksi ditagihkan ke agensi sebesar US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, sementara Meta menagihkan biaya percakapan WhatsApp ke WhatsApp Business Account milik klien. Dengan Coexistence, staf klien tetap membalas di aplikasi WhatsApp Business di samping agen.

Aturan apa yang harus dipatuhi agen?

Aturan jaringan itu sendiri, yang kodenya harus diperiksa sebelum balasan model dikirim. Platform menjaganya atas nama pelanggan mereka, karena penegakan Meta jatuh pada akun pelanggan:

  • WhatsApp: balasan teks bebas hanya dalam 24 jam sejak pesan terakhir pelanggan; setelah itu, template yang disetujui, dikirim melalui API karena aplikasi WhatsApp Business tidak dapat mengirim template dalam Coexistence.
  • WhatsApp: ketentuan Meta melarang penawaran AI sebagai fungsi utama, yang oleh referensi Partner API dirumuskan sebagai tanpa bot AI serba guna, dan mengizinkan fine-tuning pada data WhatsApp hanya untuk kepentingan eksklusif bisnis.
  • Instagram dan Facebook: DM dalam 24 jam sejak pesan terakhir orang tersebut, dan satu balasan pribadi per komentar dalam 7 hari sejak komentar dibuat.
  • TikTok: balasan atas komentar bersifat publik, karena koneksi TikTok tidak memiliki DM.
  • Volume: 20 pesan per detik per nomor Coexistence, dan template pemasaran memerlukan metode pembayaran pada WhatsApp Business Account pelanggan.

Bagaimana agen tahu saluran berhenti berfungsi?

Dari event status. connection.disconnected atau channel.disconnected berarti balasan gagal sampai pelanggan menghubungkan ulang, jadi hentikan sementara agen pelanggan tersebut, beri tahu mereka, dan kirim tautan koneksi baru; connection.token_missing berarti nomor dapat menerima tetapi belum dapat mengirim. Ketika connection.connected atau channel.connected datang kembali, ambil kredensial baru dan lanjutkan. Setiap event ditandatangani dengan X-EC-Signature, dan sistem mencoba kembali pengiriman selama sekitar 33 jam.

Kesalahan umum

  • Membiarkan model membalas pesan WhatsApp yang lebih dari 24 jam dengan teks bebas. Jendela sudah tertutup, jadi periksa waktu pesan masuk terakhir pelanggan dan beralih ke template yang disetujui.
  • Melatih model bersama dengan percakapan WhatsApp pelanggan. Ketentuan Meta hanya mengizinkan fine-tuning pada data WhatsApp Business Platform untuk kepentingan eksklusif bisnis, tidak pernah untuk memperbaiki model lain.
  • Memperlakukan smb_message_echoes sebagai pesan pelanggan. Itu adalah apa yang dikirim staf bisnis dari aplikasi, jadi berikan kepada model sebagai konteks, bukan sebagai pesan yang harus dibalas.
  • Membalas tulisan akun itu sendiri. DM Instagram yang dikirimnya kembali sebagai echo dan balasan TikTok sebagai event komentar, jadi lewati apa pun yang ditulis akun itu sendiri, atau agen akan membalas dirinya sendiri.
Melakukan ini dengan EasyCoexistence

US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah saya menggunakan model AI sendiri?

Bisa. Backend Anda menerima pesan, memanggil model apa pun yang Anda pilih, dan membalas melalui API jaringan dengan token pelanggan. Pesan dari nomor WhatsApp dikirim Meta langsung ke webhook Anda, tidak pernah melalui easyCoexistence.

Apa arti kebijakan AI Meta bagi agen WhatsApp?

Ketentuan Meta melarang penyedia AI menggunakan WhatsApp Business Platform untuk menawarkan teknologi AI sebagai fungsi utama, bukan fungsi sampingan atau pelengkap, sebagaimana ditentukan Meta. Patuhi itu atas nama pelanggan Anda, bersama jendela 24 jam dan template yang disetujui.

Bisakah agen mengirim DM di TikTok, YouTube atau LinkedIn?

Tidak. Di jaringan tersebut agen bekerja pada komentar: balasan TikTok bersifat publik, dan komentar YouTube serta LinkedIn dibaca dan dibalas melalui API mereka.

Berapa biaya easyCoexistence untuk produk agen AI?

Per koneksi, sama di setiap jaringan: US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis. Meta menagihkan biaya percakapan WhatsApp ke WhatsApp Business Account milik masing-masing pelanggan.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada