Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Cara membina produk ejen AI pada WhatsApp, Instagram dan TikTok pelanggan anda

Produk ejen AI pada saluran pelanggan bergantung kepada tiga komponen: pautan sambungan dihoskan untuk setiap nombor WhatsApp atau akaun media sosial pelanggan; webhook yang menghantar mesej dan ulasan mereka ke pelayan anda, di mana model anda sendiri menulis balasan yang dihantar melalui API rasmi setiap rangkaian menggunakan token pelanggan; serta peristiwa status bagi sambungan yang terputus. Ejen itu mematuhi peraturan setiap rangkaian, seperti tetingkap 24 jam WhatsApp.

easyCoexistence memberikan ejen AI produk anda suara pada nombor WhatsApp pelanggan anda serta akaun Instagram, Facebook, TikTok, YouTube dan LinkedIn mereka, dan lebih banyak saluran: pautan sambungan dihoskan, bukti kelayakan baharu, webhook dan peristiwa status yang ditandatangani pada API rasmi setiap rangkaian, dengan setiap sambungan dipantau 24/7.

24 hours

Tetingkap khidmat pelanggan WhatsApp bermula selepas mesej atau panggilan pengguna; setiap mesej baharu menetapkannya semula.

Templates only

Apa yang boleh dihantar oleh perniagaan WhatsApp selepas tetingkap khidmat pelanggan tamat: mesej template yang telah diluluskan terlebih dahulu.

Section 4.7

Terma Meta melarang pembekal AI menggunakan WhatsApp untuk menawarkan AI sebagai fungsi utama, bukan sampingan.

7 days

Tetingkap untuk satu balasan persendirian bagi setiap ulasan pada akaun Instagram, dikira dari masa ulasan dibuat.

20 mps

Throughput tetap bagi nombor yang digunakan dengan aplikasi WhatsApp Business dan Cloud API.

Apakah yang diperlukan oleh produk ejen AI daripada saluran setiap pelanggan?

Empat perkara: cara untuk pelanggan menyambungkannya, mesej mereka sampai ke pelayan anda, token untuk membalas, dan amaran apabila sambungan berhenti berfungsi. Partner API merangkumi kesemuanya, manakala model, prompt dan logik perbualan kekal di bawah kawalan anda. easyCoexistence menyambungkan akaun, memastikan aksesnya diperbaharui dan memantaunya, dan balasan anda dihantar terus dari pelayan anda ke API rangkaian.

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 menyambung?

Pelayan anda mencipta sesi sambungan dengan POST /connect-sessions, dengan menyatakan saluran, redirect_url dan external_ref bagi pelanggan anda, dan bagi nombor, webhook_url serta webhook_verify_token. Pelanggan membuka pautan dihoskan, log masuk dengan Meta, TikTok, Google atau LinkedIn, dan kembali ke aplikasi anda dengan connection_id atau channel_id. Mereka tidak perlukan akaun, e-mel atau kad easyCoexistence, dan setiap sambungan yang dibuat melalui kunci anda tergolong dalam akaun anda.

Bagaimana mesej dan ulasan sampai ke model anda?

Melalui webhook, pada rangkaian yang menghantarnya. Meta menghantar mesej bagi sesebuah nombor terus ke webhook_url, dan apa yang dihantar oleh kakitangan perniagaan dari aplikasi WhatsApp Business tiba di situ sebagai smb_message_echoes. Ulasan, sebutan dan DM Instagram serta Facebook, dan ulasan TikTok, dimajukan ke destinasi setiap saluran, ditandatangani dengan rahsianya. YouTube dan LinkedIn tidak menghantar peristiwa ulasan, jadi ejen membaca ulasan baharu melalui API mereka mengikut jadual. Balas setiap penghantaran dengan 2xx serta-merta dan biarkan pekerja memanggil model.

Bagaimana ejen membalas?

Melalui API rangkaian itu sendiri, dengan bukti kelayakan yang diambil oleh pelayan anda. Balasan WhatsApp ialah POST ke send_endpoint nombor dengan token pelanggan; DM Instagram atau Facebook pergi ke messages edge akaun; balasan TikTok dibuat di bawah ulasan melalui business/comment/reply/create/. Lakaran di bawah menjawab mesej WhatsApp: ia menyemak rahsia dalam laluan URL, meletakkan setiap mesej masuk dalam baris gilir dan membalas dengan apa sahaja yang dipulangkan oleh 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()

Pelayan MCP atau Partner API: yang mana digunakan oleh ejen?

Partner API, apabila ejen itu ialah produk anda dan pelanggan anda membawa saluran: pelayan anda memegang kunci, menerima peristiwa dan menjalankan mana-mana model pilihan anda. Pelayan MCP di https://easycoexistence.com/api/mcp sesuai untuk pembantu seperti Claude atau ChatGPT yang bertindak ke atas akaun easyCoexistence anda sendiri, melalui alat yang dipanggil atas permintaan selepas log masuk OAuth. Nombor dan saluran yang disambungkan dengan kunci anda turut berada pada akaun itu, jadi sesi MCP boleh mencapainya untuk kerja pasukan 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 ejen untuk ramai klien?

Pada satu akaun, dengan setiap klien ditanda. Hantar ID klien sebagai external_ref pada setiap sesi sambungan, papar nama agensi anda pada halaman dihoskan dengan partner_name, dan senaraikan sambungan seorang klien dengan GET /connections?external_ref= dan GET /channels?external_ref=. Setiap sambungan dikenakan kepada agensi pada harga daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila sambungan ditambah, manakala Meta mengenakan caj perbualan WhatsApp kepada Akaun Perniagaan WhatsApp klien itu sendiri. Dengan Coexistence, kakitangan klien kekal menjawab dalam aplikasi WhatsApp Business di sebelah ejen.

Peraturan apa yang perlu dipatuhi oleh ejen?

Peraturan rangkaian itu sendiri, yang kod anda patut semak sebelum balasan model dihantar. Platform menguatkuasakannya bagi pihak pelanggan mereka, kerana penguatkuasaan Meta menyentuh akaun pelanggan:

  • WhatsApp: balasan teks bebas hanya dalam tempoh 24 jam selepas mesej terakhir pelanggan; selepas itu, template yang telah diluluskan, dihantar melalui API kerana aplikasi WhatsApp Business tidak boleh menghantar template dalam Coexistence.
  • WhatsApp: terma Meta melarang menawarkan AI sebagai fungsi utama, yang rujukan Partner API nyatakan sebagai tiada bot AI serba guna, dan membenarkan penalaan halus (fine-tuning) pada data WhatsApp hanya untuk kegunaan eksklusif perniagaan.
  • Instagram dan Facebook: DM dalam tempoh 24 jam selepas mesej terakhir orang itu, dan satu balasan persendirian bagi setiap ulasan dalam tempoh 7 hari daripadanya.
  • TikTok: balasan kepada ulasan adalah awam, kerana sambungan TikTok tidak mempunyai DM.
  • Jumlah: 20 mesej sesaat bagi setiap nombor Coexistence, dan template pemasaran memerlukan kaedah pembayaran pada Akaun Perniagaan WhatsApp pelanggan.

Bagaimana ejen tahu sesebuah saluran berhenti berfungsi?

Daripada peristiwa status. connection.disconnected atau channel.disconnected bermakna balasan gagal sehingga pelanggan menyambung semula, jadi hentikan sementara ejen pelanggan itu, beritahu mereka, dan hantar pautan sambungan baharu; connection.token_missing bermakna nombor itu boleh menerima tetapi belum boleh menghantar. Apabila connection.connected atau channel.connected tiba semula, dapatkan bukti kelayakan baharu dan sambung semula. Setiap peristiwa ditandatangani dengan X-EC-Signature dan dicuba semula selama kira-kira 33 jam.

Kesilapan biasa

  • Membiarkan model menjawab mesej WhatsApp yang lebih 24 jam lamanya dengan teks bebas. Tetingkap sudah tamat, jadi semak masa mesej masuk terakhir pelanggan dan tukar kepada template yang telah diluluskan.
  • Melatih model yang dikongsi menggunakan perbualan WhatsApp pelanggan. Terma Meta membenarkan penalaan halus pada data WhatsApp Business Platform hanya untuk kegunaan eksklusif perniagaan, bukan untuk meningkatkan model lain.
  • Menganggap smb_message_echoes sebagai mesej pelanggan. Ia ialah apa yang kakitangan perniagaan hantar dari aplikasi, jadi berikannya kepada model sebagai konteks, bukan sebagai mesej untuk dibalas.
  • Membalas balasan akaun itu sendiri. DM Instagram yang dihantarnya kembali sebagai echo dan balasan TikTok sebagai peristiwa ulasan, jadi langkau apa sahaja yang ditulis oleh akaun itu sendiri, atau ejen akan membalas dirinya sendiri.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari.

Soalan lazim

Bolehkah saya menggunakan model AI sendiri?

Boleh. Pelayan anda menerima mesej, memanggil mana-mana model pilihan anda dan membalas melalui API rangkaian dengan token pelanggan. Mesej nombor WhatsApp dihantar daripada Meta terus ke webhook anda, tidak sekali-kali melalui easyCoexistence.

Apakah maksud dasar AI Meta bagi ejen WhatsApp?

Terma Meta melarang pembekal AI menggunakan WhatsApp Business Platform untuk menawarkan teknologi AI sebagai fungsi utama, bukan sampingan atau tambahan, seperti yang Meta tentukan. Patuhinya bagi pihak pelanggan anda, bersama tetingkap 24 jam dan template yang telah diluluskan.

Bolehkah ejen menghantar DM di TikTok, YouTube atau LinkedIn?

Tidak. Pada rangkaian tersebut ejen bekerja dalam ulasan: balasan TikTok adalah awam, dan ulasan YouTube serta LinkedIn dibaca dan dibalas melalui API mereka.

Berapakah kos easyCoexistence bagi produk ejen AI?

Bagi setiap sambungan, sama di setiap rangkaian: daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari. Meta mengenakan caj perbualan WhatsApp kepada Akaun Perniagaan WhatsApp setiap pelanggan.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada