AccediInizia la prova gratuita
easyCoexistence API ufficiali

Come aggiungere WhatsApp al tuo SaaS con Embedded Signup e Coexistence

Un SaaS aggiunge WhatsApp collegando il numero esistente di ogni cliente tramite Embedded Signup di Meta con Coexistence, così il numero continua a funzionare nell'app WhatsApp Business. Con la Partner API di easyCoexistence, una sessione di connessione per cliente esegue questo flusso su una pagina ospitata, Meta recapita i messaggi del numero al tuo webhook_url e il tuo backend risponde tramite la Cloud API con il token del cliente.

20 mps

Throughput fisso di un numero usato sia con l'app WhatsApp Business sia con la Cloud API.

2.24.17

La versione più vecchia dell'app WhatsApp Business con cui il numero di un cliente può connettersi tramite Coexistence.

180 days

Fino a quanto indietro può arrivare la cronologia delle chat che Meta può condividere all'onboarding; va sincronizzata entro 24 ore.

24 hours

La finestra di assistenza clienti di WhatsApp dopo un messaggio o una chiamata dell'utente; ogni nuovo messaggio la reimposta.

October 15, 2026

La data in cui Meta ha dismesso Embedded Signup v2 e v3, con le integrazioni passate alla v4.

Quali sono le parti di un'integrazione WhatsApp?

Cinque, e easyCoexistence si occupa della prima e dell'ultima. Il tuo prodotto gestisce la logica delle conversazioni, la casella dei messaggi e tutto ciò che scrivono il tuo modello o il personale dei tuoi clienti, mentre Meta trasporta i messaggi tra il numero e il tuo server:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

Cosa cambia Coexistence per i tuoi clienti?

Mantengono il loro numero e il loro telefono. L'app WhatsApp Business continua a funzionare accanto alla Cloud API, quindi il personale risponde dal telefono mentre il tuo prodotto risponde tramite l'API, e ciò che inviano dall'app arriva al tuo webhook come smb_message_echoes. Ci sono tre limiti: il numero invia a una velocità fissa di 20 messaggi al secondo, solo l'API può inviare template, e Meta disconnette il numero quando il telefono resta inattivo per circa 14 giorni.

Come appare il passaggio di connessione nel tuo prodotto?

Un pulsante Connect WhatsApp che chiama POST /connect-sessions dal tuo backend con un redirect_url, l'id del cliente come external_ref e webhook_url con webhook_verify_token, così Meta instrada il numero verso di te fin dal primo minuto. Il cliente conferma una breve checklist nella pagina ospitata, avvia il popup di Meta, scansiona un codice QR con l'app WhatsApp Business e torna da te con un connection_id. Se usare Embedded Signup dalla tua app Tech Provider invece viene valutato nella guida a Embedded Signup.

Come arrivano i messaggi al tuo backend?

Da Meta, direttamente al webhook_url, senza passare da easyCoexistence e senza copie conservate. Il campo messages contiene ciò che inviano i clienti e lo stato di ciò che invii tu, mentre smb_message_echoes contiene ciò che il personale invia dall'app. Meta firma ogni consegna con l'app secret di easyCoexistence, che non viene mai condiviso, quindi un segreto lungo e casuale nel percorso dell'URL la autentica. Due numeri nello stesso WhatsApp Business Account condividono una destinazione: instrada in base a value.metadata.phone_number_id.

Come risponde il tuo backend e invia i template?

Con la Graph API di Meta e il token del cliente da GET /connections/{id}?credentials=1, che restituisce anche il send_endpoint. Il testo libero viene inviato entro 24 ore dall'ultimo messaggio della persona; dopo, solo un template approvato da Meta:

  • Risposta: POST /<PHONE_NUMBER_ID>/messages con type text, entro la finestra.
  • Template: la stessa chiamata con type template, il nome del template e il suo codice lingua.
  • Creare un template: POST /<WABA_ID>/message_templates, poi interroga il suo stato, perché gli esiti della revisione non arrivano al tuo webhook_url.
  • Media: POST /<PHONE_NUMBER_ID>/media per caricare; i media in arrivo arrivano come ID da recuperare con lo stesso token.
Reply inside the customer service window
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511987654321",
    "type": "text",
    "text": { "body": "Your table for 4 is booked for 8 pm." }
  }'

Il tuo prodotto può importare le chat esistenti del cliente?

Una sola volta, alla connessione. Con un webhook_url impostato sulla sessione, easyCoexistence chiede a Meta di inviare i contatti del numero e, se il cliente accetta nell'app, fino a 180 giorni di chat, che arrivano come webhook smb_app_state_sync e history. Meta lo consente solo entro 24 ore dalla connessione, quindi fai in modo che l'endpoint risponda prima che il link venga inviato. La guida alla cronologia delle chat descrive i payload.

Chi paga Meta per i messaggi?

Il tuo cliente. Meta addebita i messaggi che il backend invia tramite API sul WhatsApp Business Account del cliente, con un metodo di pagamento che aggiunge lì, e un'azienda senza metodo di pagamento non può inviare template di marketing. easyCoexistence addebita al tuo account per ogni numero connesso e non applica mai costi sui messaggi né ricarica i prezzi di Meta.

Cosa succede quando un numero cade?

Il tuo URL degli eventi riceve connection.disconnected con il motivo di Meta, quando è noto. PRIMARY_INACTIVITY è la regola dei 14 giorni, e una nuova sessione di connessione per quel cliente riporta lo stesso numero. connection.token_missing significa che il numero è stato connesso senza il token del cliente: riceve messaggi ma non può inviarne finché una nuova sessione non lo riconnette.

Errori comuni

  • Inviare il link di connessione prima che il tuo endpoint webhook risponda. L'importazione della cronologia avviene una sola volta, entro 24 ore dalla connessione, e i contenuti inviati prima che il tuo URL funzioni vanno persi.
  • Rispondere con testo libero dopo la chiusura della finestra. Trascorse 24 ore dall'ultimo messaggio della persona, passa solo un template approvato.
  • Avviare una campagna da un numero alla massima velocità. Un numero Coexistence invia a 20 messaggi al secondo, quindi metti in coda gli invii di ogni numero a quella velocità.
  • Aspettarsi che il personale invii i template dal telefono. In Coexistence solo l'API li invia, quindi gestisci gli invii dei template nel tuo prodotto.
Farlo con EasyCoexistence

easyCoexistence aggiunge WhatsApp al tuo SaaS con Embedded Signup di Meta e Coexistence su una pagina ospitata che mostra il tuo nome: i tuoi clienti mantengono il loro numero e l'app WhatsApp Business, Meta consegna i messaggi al tuo server e ti raggiunge con eventi firmati. La stessa API collega Instagram, Facebook, TikTok, YouTube, LinkedIn e altri canali. US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni gratuiti.

Domande frequenti

Un cliente può collegare un numero che è su un altro provider API di WhatsApp?

Non finché è lì. La checklist ospitata chiede un numero senza altri provider API o strumenti di automazione, quindi il cliente lo disconnette prima da quel provider.

Il mio SaaS può inviare template WhatsApp per i suoi clienti?

Sì, tramite la Cloud API con il token di ciascun cliente: crea il template sul WhatsApp Business Account del cliente, attendi la revisione di Meta, poi invialo.

easyCoexistence legge i messaggi WhatsApp dei miei clienti?

No. Meta consegna i messaggi di un numero direttamente al webhook_url che imposti. Un numero senza webhook_url ricade sul callback di easyCoexistence, dove i messaggi vengono scartati senza essere conservati.

Quanto costa easyCoexistence per numero WhatsApp?

US$ 9 a US$ 0,75 per numero al mese, in base alla fascia delle connessioni totali, con i primi 3 giorni gratuiti. Gli addebiti di Meta per i messaggi vanno al WhatsApp Business Account di ogni 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