Come creare un prodotto con agente IA su WhatsApp, Instagram e TikTok dei tuoi clienti
Un prodotto con agente IA sui canali dei clienti poggia su tre elementi: un link di connessione ospitato per il numero WhatsApp o l'account social di ogni cliente; webhook che portano messaggi e commenti al tuo backend, dove il tuo modello scrive le risposte, inviate tramite l'API ufficiale di ogni rete con il token del cliente; ed eventi di stato per le connessioni che cadono. L'agente rispetta le regole di ogni rete, come la finestra di 24 ore di WhatsApp.
easyCoexistence dà ai tuoi agenti IA una voce sui numeri WhatsApp dei tuoi clienti e sugli account Instagram, Facebook, TikTok, YouTube e LinkedIn, e su altri canali in arrivo: link di connessione ospitati, credenziali sempre aggiornate, webhook ed eventi di stato firmati, sull'API ufficiale di ogni rete, con ogni connessione monitorata 24 ore su 24.
Finestra di assistenza clienti di WhatsApp dopo un messaggio o una chiamata dell'utente; ogni nuovo messaggio la riavvia.
Ciò che un'azienda WhatsApp può inviare dopo la chiusura della finestra di assistenza clienti: messaggi template pre-approvati.
Le condizioni di Meta vietano ai fornitori di IA di usare WhatsApp per offrire l'IA come funzione principale, e non accessoria.
Finestra per l'unica risposta privata a un commento su un account Instagram, conteggiata dal momento in cui il commento è stato scritto.
Velocità di invio fissa di un numero usato sia con l'app WhatsApp Business sia con la Cloud API.
Di cosa ha bisogno un prodotto con agente IA dal canale di ogni cliente?
Quattro cose: un modo per il cliente di collegarlo, i suoi messaggi che arrivano al tuo backend, un token per rispondere e un segnale quando la connessione smette di funzionare. La Partner API copre ciascuna di queste, mentre il modello, i prompt e la logica delle conversazioni restano tuoi. easyCoexistence collega l'account, mantiene rinnovato l'accesso e lo monitora, e le tue risposte vanno dal tuo backend direttamente all'API della rete.
Come si connette ogni cliente?
Il tuo backend crea una sessione di connessione con POST /connect-sessions, indicando il canale, un redirect_url e un external_ref per il cliente, e per un numero il suo webhook_url e il webhook_verify_token. Il cliente apre il link ospitato, accede con Meta, TikTok, Google o LinkedIn e torna alla tua app con connection_id o channel_id. Non serve un account easyCoexistence, un'e-mail o una carta, e ogni connessione creata con la tua chiave appartiene al tuo account.
Come arrivano messaggi e commenti al tuo modello?
Tramite webhook, sulle reti che li inviano. Meta consegna i messaggi di un numero direttamente al suo webhook_url, e ciò che lo staff dell'azienda invia dall'app WhatsApp Business arriva lì come smb_message_echoes. I commenti, le menzioni e i DM di Instagram e Facebook, e i commenti di TikTok, sono inoltrati alla destinazione di ogni canale, firmati con il suo segreto. YouTube e LinkedIn non inviano eventi di commento, quindi l'agente legge i nuovi commenti tramite le loro API a intervalli programmati. Rispondi a ogni consegna con 2xx immediatamente e lascia che un worker richiami il modello.
Come risponde l'agente?
Tramite l'API della rete stessa, con le credenziali recuperate dal tuo backend. Una richiesta POST al send_endpoint del numero, con il token del cliente, è una risposta WhatsApp; un DM di Instagram o Facebook va al messages edge dell'account; una risposta TikTok va sotto al commento tramite business/comment/reply/create/. L'esempio qui sotto risponde ai messaggi WhatsApp: controlla il segreto nel percorso dell'URL, mette in coda ogni messaggio in arrivo e risponde con quello che restituisce il tuo modello.
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()Server MCP o Partner API: quale usa l'agente?
La Partner API, quando l'agente è il tuo prodotto e i tuoi clienti portano i canali: il tuo backend custodisce la chiave, riceve gli eventi ed esegue il modello che scegli. Il server MCP su https://easycoexistence.com/api/mcp si adatta a un assistente come Claude o ChatGPT che opera sul tuo account easyCoexistence, tramite strumenti che chiama su richiesta dopo un accesso OAuth. I numeri e i canali collegati con la tua chiave stanno anche su quell'account, quindi una sessione MCP può raggiungerli per il lavoro del tuo team.
| Partner API | MCP server | |
|---|---|---|
| Built for | Your product, serving your customers | An assistant working on your own account |
| Signs in with | An ec_live_ key, one per account | OAuth, from Claude, ChatGPT or another client |
| Incoming messages | Webhooks to your backend | Read when the assistant calls a tool |
| The model | Any model you run | The assistant's own |
| Replies | Your code calls each network's API | Tools such as send_message and reply_to_comment |
Come gestiscono le agenzie agenti per molti clienti?
Su un unico account, con ogni cliente etichettato. Passa l'ID del cliente come external_ref in ogni sessione di connessione, mostra il nome della tua agenzia sulla pagina ospitata con partner_name, ed elenca le connessioni di un cliente con GET /connections?external_ref= e GET /channels?external_ref=. Ogni connessione è fatturata all'agenzia da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che si aggiungono connessioni, mentre Meta fattura gli addebiti delle conversazioni WhatsApp all'account WhatsApp Business del cliente. Con Coexistence, lo staff del cliente continua a rispondere nell'app WhatsApp Business accanto all'agente.
Quali regole deve rispettare l'agente?
Quelle delle reti, che il tuo codice dovrebbe verificare prima che la risposta del modello esca. Le piattaforme le applicano per conto dei loro clienti, dato che l'applicazione di Meta ricade sull'account del cliente:
- WhatsApp: risposte in testo libero solo entro 24 ore dall'ultimo messaggio del cliente; dopo, un template approvato, inviato tramite l'API perché l'app WhatsApp Business non può inviare template in Coexistence.
- WhatsApp: le condizioni di Meta vietano di offrire l'IA come funzionalità principale, che il riferimento della Partner API definisce come nessun bot IA di uso generale, e consentono il fine-tuning sui dati WhatsApp solo per uso esclusivo dell'azienda.
- Instagram e Facebook: DM entro 24 ore dall'ultimo messaggio della persona, e una sola risposta privata per commento entro 7 giorni da esso.
- TikTok: le risposte ai commenti sono pubbliche, perché una connessione TikTok non ha DM.
- Volume: 20 messaggi al secondo per numero Coexistence, e i template di marketing richiedono un metodo di pagamento sull'account WhatsApp Business del cliente.
Come fa l'agente a sapere che un canale ha smesso di funzionare?
Dagli eventi di stato. connection.disconnected o channel.disconnected significa che le risposte falliscono finché il cliente non ricollega, quindi metti in pausa l'agente di quel cliente, avvisalo e invia un nuovo link di connessione; connection.token_missing significa che il numero può ricevere ma non può ancora inviare. Quando arriva di nuovo connection.connected o channel.connected, recupera credenziali nuove e riprendi. Ogni evento è firmato con X-EC-Signature e ritentato per circa 33 ore.
Errori comuni
- Lasciare che il modello risponda a un messaggio WhatsApp più vecchio di 24 ore con testo libero. La finestra è chiusa, quindi controlla l'ultimo orario di messaggio in entrata del cliente e passa a un template approvato.
- Addestrare un modello condiviso sulle conversazioni WhatsApp dei clienti. Le condizioni di Meta consentono il fine-tuning sui dati della WhatsApp Business Platform solo per uso esclusivo dell'azienda, mai per migliorare altri modelli.
- Trattare smb_message_echoes come messaggi dei clienti. Sono ciò che lo staff dell'azienda ha inviato dall'app, quindi dai al modello come contesto, non come messaggi a cui rispondere.
- Rispondere ai messaggi dell'account stesso. I DM che invia tornano come echo su Instagram e le risposte TikTok come eventi di commento, quindi salta tutto ciò che l'account ha scritto da sé, altrimenti l'agente risponde a se stesso.
Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo decrescente man mano che aggiungi connessioni, e i primi 3 giorni gratuiti.
Domande frequenti
Posso usare il mio modello IA?
Sì. Il tuo backend riceve i messaggi, chiama il modello che scegli e risponde tramite l'API della rete con il token del cliente. I messaggi di un numero WhatsApp vanno da Meta direttamente al tuo webhook, mai passando da easyCoexistence.
Cosa significa la politica IA di Meta per un agente WhatsApp?
Le condizioni di Meta vietano ai fornitori di IA di usare la WhatsApp Business Platform per offrire tecnologia IA come funzionalità principale, anziché accessoria o secondaria, come determinato da Meta. Rispettala per conto dei tuoi clienti, insieme alla finestra di 24 ore e ai template approvati.
L'agente può inviare DM su TikTok, YouTube o LinkedIn?
No. Su quelle reti l'agente lavora nei commenti: le risposte TikTok sono pubbliche, e i commenti di YouTube e LinkedIn vengono letti e ricevono risposta tramite le loro API.
Quanto costa easyCoexistence per un prodotto con agente IA?
Per connessione, uguale su ogni rete: da US$ 9 a US$ 0,75 per connessione al mese, con prezzo decrescente all'aumentare delle connessioni, e i primi 3 giorni gratuiti. Meta fattura gli addebiti delle conversazioni WhatsApp all'account WhatsApp Business di ciascun cliente.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il