REST API e token

Oltre al costruttore visuale, GetMyBot è accessibile in modo programmatico: i dati del bot possono essere gestiti tramite REST API. Esistono due tipi di token — per l'accesso a un bot specifico e personali (per automazioni e integrazioni a livello di account).

Token API del bot

Si creano in Impostazioni → Token API. Ogni token è legato a un bot e permette di accedere ai suoi endpoint REST (reazioni, utenti, raccolte, statistiche, ecc.). Il token viene mostrato una sola volta al momento della creazione — salvalo in un posto sicuro; nell'elenco compaiono nome, maschera e data di creazione. Elimina i token non necessari.

Token di accesso personali (PAT)

I token di accesso personali (PAT, che iniziano con mbp_) funzionano a livello di account e vengono usati per automazioni e integrazioni. Si creano nell'area personale; vanno passati nell'intestazione Authorization: Bearer mbp_…. Il token ha degli ambiti (scopes) — un insieme di permessi nel formato risorsa:azione (ad esempio reactions:read, bots:write), mentre * indica accesso completo. La scadenza è limitata e i token vengono conservati in forma hash. È il modo pratico per dare a uno script un accesso limitato senza fornire la password.

Cosa è accessibile tramite API

Tramite API sono disponibili le stesse entità dell'interfaccia: bot e relative impostazioni, reazioni (incluso import/export), iscritti ed etichette, raccolte e record, statistiche e registro delle richieste, trasmissioni. Questo permette di costruire dashboard personalizzate, sincronizzazioni e automazioni sopra GetMyBot.

Canali e WhatsApp

GetMyBot è multicanale (Telegram + WhatsApp + VK) e i canali di un bot si gestiscono anch'essi via REST. I canali e i template WhatsApp sono regolati dagli scope condivisi bots:read / bots:write — non esiste uno scope separato per i canali.

  • GET /api/channels/capabilities — la matrice delle capacità dei canali (endpoint di sessione, non richiede scope PAT).
  • GET /api/bots/{botID}/channels (bots:read) — elenca i canali di un bot.
  • POST /api/bots/{botID}/channels (bots:write) — collega un canale WhatsApp o VK.
  • DELETE /api/bots/{botID}/channels/{channelID} (bots:write) — scollega un canale.
  • GET /api/bots/{botID}/channels/{channelID}/templates (bots:read) — il catalogo dei template WhatsApp del canale.
  • POST /api/bots/{botID}/channels/{channelID}/templates (bots:write) — crea un template e lo invia alla moderazione di Meta.
  • POST /api/bots/{botID}/channels/{channelID}/templates/sync (bots:write) — risincronizza il catalogo da Meta.
  • PUT /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — modifica un template.
  • DELETE /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — elimina un template.
  • POST /api/bots/{botID}/channels/{channelID}/templates/media (bots:write) — carica un esempio di header multimediale (immagine/video/documento).

Gli schemi di richiesta e risposta, i parametri e gli esempi sono nel Riferimento API. La descrizione lato utente dei canali e dei template è nella pagina WhatsApp.

Accesso mobile

La piattaforma dispone di un'app mobile con autenticazione propria (token di accesso e refresh) e una dashboard riassuntiva dei bot — utilizza lo stesso backend.

Riferimento API

Il riferimento interattivo completo dell'API pubblica è disponibile nella pagina Riferimento API: elenca tutti gli endpoint disponibili con PAT, i parametri, gli schemi di richiesta e risposta, gli scopes richiesti e esempi pronti (curl, JavaScript, Python). Direttamente dalla pagina puoi eseguire una richiesta di prova con il tuo token.

Sicurezza

  • I token vengono mostrati una sola volta; trattali come segreti.
  • I segreti dei bot e delle credenziali sono conservati in forma cifrata.
  • Le mutazioni vengono registrate nel log di audit.

Passo successivo