Creare un account e una chiave
Due modi per ottenere una chiave: dall'interno di Bitrix24, oppure nella console sviluppatori con e-mail e password. Nessun redirect URI, nessun PKCE, nessuna schermata di consenso.
Esistono due modi altrettanto validi per ottenere una API key, a seconda di come utilizzate WASync.
Aprite l'app in Bitrix24, andate su Impostazioni → API e agenti e individuate la scheda Chiavi API. Assegnate un nome all'integrazione e fate clic su Crea chiave.
Per creare una chiave serve almeno una connessione con il componente aggiuntivo API attivo
($12 per numero al mese). Senza di esso, il pulsante è disattivato e ne indica
il motivo, mentre il server risponde 403 addon_required. La chiave viene mostrata una sola volta,
proprio lì, con un pulsante Copia, e include gli scope standard
whatsapp.read whatsapp.send.
Le allowlist di IP, la configurazione dei webhook e la gestione di più portali da un unico account si trovano nella console sviluppatori, non in questa scheda: la scheda rimanda a essa.
La chiave viene mostrata una sola volta: ne viene memorizzato solo un hash. Copiatela subito nel vostro ambiente.
export WASYNC_API_KEY=wsk_live_…Inviatela a ogni richiesta:
Authorization: Bearer $WASYNC_API_KEYQuesta è l'intera configurazione dell'autenticazione. Nessun redirect URI, nessun PKCE, nessuna schermata di consenso, nessun aggiornamento del token.
Scope
Selezionate solo ciò che serve all'integrazione: gli scope sono definiti per ogni chiave.
| Scope | Cosa consente |
|---|---|
whatsapp.read | Elencare le connessioni e leggere i messaggi. |
whatsapp.send | Inviare messaggi e leggere le conferme di lettura. |
whatsapp.events | Ricevere webhook e configurare la loro destinazione. |
whatsapp.manage | Creare, ispezionare, riavviare, disconnettere ed eliminare connessioni. |
Gli scope e l'elenco delle connessioni raggiungibili vengono risolti in tempo reale a ogni richiesta, quindi revocare una chiave o restringerne i permessi ha effetto già dalla chiamata successiva: non c'è nulla in cache e nulla da aggiornare. I dettagli, e cosa comporta la fuga di ciascuno scope, sono descritti in Scope.
Non potete bloccare voi stessi
La allowlist di IP facoltativa viene applicata solo alle chiamate API. La pagina in cui la modificate è autenticata dal vostro account, non dalla chiave, quindi resta raggiungibile da qualsiasi indirizzo. Consultate Allowlist di IP.
Quanto costa una connessione
Ogni numero WhatsApp richiede una licenza attiva per inviare e ricevere. Un nuovo numero
inizia con una prova gratuita di 7 giorni, poi costa $19 per numero al mese per un numero qr
(WAPP) oppure $29 per numero al mese per un numero cloud_api (WABA), in
USD. Su un portale Bitrix24, l'accesso API a un numero è un componente aggiuntivo separato da $12 per numero
al mese. Licenze e prova offre il quadro
completo.