Aiuto

Iniziare

Dalla registrazione al primo cliente che ha ricevuto risposta: sei passaggi. Alla prima registrazione ottieni un mese di prova con accesso completo.

Collegamento dei canali

Guide dettagliate per ciascun canale. I canali vengono collegati per sito (widget) nella dashboard, nella sezione “Canali”; dopo aver salvato un canale Smartbtn verifica che la piattaforma accetti i messaggi. I messaggi da ogni canale arrivano in “Conversazioni”.

Bot di TelegramAvrai bisogno di: un bot di @BotFather, il suo nome utente e token.6 passi → Comunità VKAvrai bisogno di: una chiave di accesso alla community e il collegamento o ID della community.5 passi → Bot MAXAvrai bisogno di: un'organizzazione verificata su business.max.ru, il nickname e il token del bot.6 passi → WhatsApp Business (API cloud)Avrai bisogno di: un'app Meta Business con WhatsApp, un numero, un ID numero di telefono, un ID WABA e un token permanente.6 passi · circa 10 minuti → Conti AvitoAvrai bisogno di: un account Avito con un abbonamento adatto; autorizzazione tramite Avito.4 passaggi → CIANOAvrai bisogno di: il piano CIAN “Base”, la chiave API CIAN e l’indirizzo dell’account.5 passi → Messaggero di FacebookAvrai bisogno di: un token di accesso alla Pagina di lunga durata e l'indirizzo della Pagina.5 passi → Bot ViberAvrai bisogno di: un bot Viber commerciale, il suo URI e il token (chiave dell'app).5 passi → OK gruppoAvrai bisogno di: una chiave di accesso e il collegamento alla finestra di dialogo del gruppo.6 passi → AliExpressAvrai bisogno di: un token API dall'account venditore AliExpress e l'indirizzo o l'ID del negozio.5 passi → Messaggi Apple per le aziendeAvrai bisogno di: un account Messages for Business collegato a Infobip, un ID Apple Business e una chiave API Infobip.7 passi → WordPress e altri CMSInstallazione del codice del widget su un sito realizzato con un CMS.3 passaggi →

Bot di Telegram

I clienti scrivono al tuo bot in Telegram, tu rispondi da Smartbtn: la risposta arriva in Telegram.

1. Crea un bot con @BotFatherIn Telegram apri @BotFather, invia il comando /newbot e imposta il nome e il nome utente del bot. Il nome utente deve terminare con "bot".
2. Copia il tokenBotFather invia un token come 123456:AAH… — copialo completamente.
3. Inserisci il nome utente del botNella dashboard apri “Canali”, scegli Telegram e inserisci il nome utente del bot senza @.
4. Incolla il tokenIncolla il token nel campo “Token bot”.
5. Connetti TelegramFai clic su "Connetti Telegram". Smartbtn chiede a Telegram se il bot risponde: il segno verde appare solo dopo la risposta.
6. Invia /start al botApri il bot in Telegram e invialo /start. Successivamente può parlare con i clienti.

Comunità VK

I messaggi alla tua comunità VK arrivano su Smartbtn; le risposte tornano a VK per conto della comunità. Puoi connettere diverse comunità.

1. Crea una chiave di accesso alla communityNella community aprire “Gestisci” → “Avanzate” → “Utilizzo API” → scheda “Token di accesso” → “Crea token”. Spuntare i diritti “Messaggi della community”, “Gestione della community”, “Foto”, “Documenti” e cliccare su “Crea”; confermare nell'app VK o tramite SMS.
2. Incolla la chiaveNella dashboard apri “Canali” → VK e incolla la chiave nel campo “Token comunità”.
3. Specificare la comunitàNel campo “Link o ID comunità” incolla l'indirizzo della comunità (es. vk.com/club123456) o il suo ID numerico.
4. Connetti la comunitàFare clic su "Connetti". La ricezione dei messaggi (API Callback, evento message_new) viene configurata automaticamente: non c'è nient'altro da fare.
5. ControllaInvia un messaggio di prova alla community: dovrebbe apparire in "Conversazioni".

Bot MAX

I messaggi al tuo bot nel messenger MAX arrivano a Smartbtn, le risposte tornano a MAX.

1. Crea un bot sulla piattaforma partner MAXAccedi a business.max.ru (o alla mini‑app “MAX for business”), crea e verifica il profilo della tua organizzazione, ditta individuale o lavoratore autonomo (disponibile per i residenti in Russia), quindi in “Chat bot” fai clic su “Crea”.
2. Compila la scheda botCarica un logo, imposta il nome e la descrizione. Il nickname viene generato automaticamente (come idINN_bot). Dopo la creazione, il bot passa attraverso la moderazione.
3. Copia il tokenDopo la moderazione apri “Chat bot” → il tuo bot → ⋮ → “Impostazioni” e copia il token.
4. Inserisci il soprannome del botNella dashboard apri “Canali” → MAX e inserisci il nickname senza @.
5. Incolla il tokenIncolla il token nel campo “Token bot”.
6. SalvaFare clic su "Salva impostazioni".

WhatsApp Business (API cloud)

WhatsApp si connette tramite l'API ufficiale Meta WhatsApp Business Cloud: un unico numero risponde alle conversazioni e invia mail con template approvati. La configurazione nella sezione “Connessioni” richiede circa 10 minuti.

1. Crea un'app MetaIn Meta for Developers crea un'app Business (o utilizzane una esistente) e aggiungi il prodotto WhatsApp.
2. Aggiungi il numeroWhatsApp → Configurazione API: aggiungi il tuo numero (non deve essere utilizzato nell'app WhatsApp), confermalo con un codice e attendi l'approvazione del nome visualizzato.
3. Copia gli IDCopia l'ID del numero di telefono e l'ID dell'account aziendale di WhatsApp.
4. Crea un token permanenteMeta Business → Impostazioni → Utenti di sistema: crea un amministratore, dagli l'app e l'account WhatsApp, genera un token che non scade mai con i permessi whatsapp_business_messaging e whatsapp_business_management.
5. Salva e controllaNella dashboard apri “Connessioni” → WhatsApp, incolla i dati e clicca su “Salva e controlla”.
6. Attiva i messaggi in arrivoFai clic su "Connetti automaticamente" e scegli i siti (progetti) per le risposte e gli invii.

Conti Avito

Le chat di Avito sono collegate da account: ogni account è un'autorizzazione separata in Avito, puoi aggiungerne diversi. È richiesto un abbonamento Avito: “Massimo” per Beni e Lavori, “Esteso” o “Massimo” per Servizi.

1. Assegna un nome all'accountIn “Canali” → Avito inserisci il nome di un account (fino a 50 caratteri): aiuta a distinguere gli account.
2. Aggiungi l'accountFai clic su "Aggiungi account": si apre la pagina di autorizzazione di Avito.
3. Consenti l'accessoAccedi all'account Avito corretto, verifica i diritti di lettura e modifica dei messaggi in Avito Messenger e fai clic su "Autorizza applicazione".
4. Gestisci gli accountAggiungi altri account o elimina quelli non necessari: l'elenco si trova nella stessa pagina.

CIANO

I messaggi dal tuo account CIAN arrivano a Smartbtn.

1. Ottieni la chiave API CIANÈ richiesto il piano “Base”. Nell'account CIAN apri la sezione API e fai clic su "Ottieni chiave API".
2. Trova la chiave nella tua emailCIAN invia la CHIAVE DI ACCESSO all'e‑mail dell'account. Assicurati inoltre che la ricezione dei messaggi sia abilitata su my.cian.ru/settings/chats.
3. Inserisci l'indirizzo dell'accountIn “Canali” → CIAN incolla l'indirizzo del tuo account CIAN.
4. Incolla la chiaveIncolla la chiave nel campo "Chiave API CIAN (CHIAVE DI ACCESSO)".
5. SalvaFare clic su "Salva impostazioni".

Messaggero di Facebook

I messaggi inviati alla tua Pagina Facebook in Messenger arrivano a Smartbtn. Messenger consente risposte in formato libero entro 24 ore dal messaggio del cliente.

1. Scegli MessengerIn "Canali" fai clic sull'icona di Messenger.
2. Ottieni il token della PaginaOttieni un token di accesso alla pagina di lunga durata seguendo la guida Meta for Developers.
3. Inserisci l'indirizzo della paginaIncolla l'indirizzo della pagina Facebook nel campo "Indirizzo pagina Facebook".
4. Incolla il tokenIncolla il token della Pagina nel campo "Chiave segreta".
5. SalvaFare clic su "Salva impostazioni".

Bot Viber

I messaggi al tuo bot Viber arrivano a Smartbtn.

1. Scegli ViberIn "Canali" fai clic sull'icona Viber.
2. Ottieni un bot ViberDal 5 febbraio 2024 i bot Viber vengono creati solo a condizioni commerciali: rivolgiti direttamente a Viber o tramite il suo partner ufficiale (developers.viber.com). Il token si trova in Viber: Altro → Impostazioni → Bot → Modifica informazioni → “Chiave della tua app”.
3. Inserisci l'URI del botIncolla l'URI del bot (lo stesso dei collegamenti viber://pa?chatURI=…) nel campo “Bot URI”.
4. Incolla il tokenIncolla la chiave dell'app nel campo "Token bot".
5. SalvaFare clic su "Salva impostazioni".

OK gruppo

I messaggi al tuo gruppo OK arrivano su Smartbtn.

1. Ottieni una chiave di accessoOttieni la chiave di accesso del gruppo come descritto nella guida API OK.
2. Scegli OKIn “Canali” fare clic sull'icona OK.
3. Inserisci l'indirizzo del gruppoNelle impostazioni del gruppo copia da "Collegamento diretto alla finestra di dialogo del gruppo" la parte come group/58269558636565/messages e incollala nel campo "Indirizzo del gruppo".
4. Incolla la chiaveIncolla la chiave del passaggio 1 nel campo "Chiave di accesso (token)".
5. SalvaFare clic su "Salva impostazioni". Il webhook viene registrato automaticamente.
6. ControllaSmartbtn mostra se OK ha confermato la ricezione dei messaggi. Invia un messaggio di prova al gruppo: apparirà in "Conversazioni".

AliExpress

I messaggi degli acquirenti da AliExpress arrivano a Smartbtn.

1. Apri la pagina dei token APIAccedi all'account venditore (seller.aliexpress.ru) e apri seller.aliexpress.ru/token‑management/active.
2. Crea un gettoneFai clic su "Crea token", quindi fai clic sul token e copialo.
3. Specificare il negozioIn “Canali” → AliExpress inserisci l'indirizzo o l'ID del tuo negozio.
4. Incolla il tokenIncolla il token nel campo "Token API".
5. SalvaFare clic su "Salva impostazioni".

Apple Messages for Business

I messaggi di Apple Messages for Business (ex Business Chat) arrivano a Smartbtn tramite il provider Infobip: Apple non fornisce alle aziende un accesso diretto.

1. Registrati con AppleNell'Apple Business Register (register.apple.com) registra l'organizzazione e crea un account Messages for Business; scegli Infobip come Fornitore del Servizio di Messaggistica.
2. Collega l'account con InfobipCollega l'account al tuo account Infobip e attendi l'approvazione di Apple: lo stato diventa ONLINE.
3. Inserisci l'URL di Infobip BaseIn “Canali” → Messaggi per Business incolla il tuo URL Infobip Base (come xxxxx.api.infobip.com).
4. Inserisci l'ID aziendale AppleCopialo nel Registro delle Imprese di Apple: l'account Messages for Business → “Link” → “Copia ID”.
5. Incolla la chiave API InfobipCrea una chiave API in Infobip (gestione delle chiavi API) e incollala: l'URL di richiamata viene visualizzato di seguito.
6. Imposta l'URL di richiamata in InfobipIn Infobip: Canali e Numeri → Canali → Apple Messages for Business → Mittenti → ⋮ → Modifica configurazioni in entrata → Inoltro su HTTP, incolla l'URL di richiamata.
7. SalvaFare clic su "Salva impostazioni".

WordPress, Tilda e altri CMS

Il widget viene installato con un codice di installazione: funziona su qualsiasi sito e CMS.

1. Copia il codice di installazioneNella dashboard apri “Widget” e copia il codice di installazione.
2. Incollalo nel sitoAggiungi il codice a ogni pagina prima del tag di chiusura : in WordPress - tramite il tema (footer.php) o qualsiasi plugin per inserire codice nell'intestazione/piè di pagina; in altri CMS: nel campo per il codice HTML/JS personalizzato.
3. ControllaApri il sito: viene visualizzato il pulsante; ulteriori modifiche al design vengono apportate nella dashboard senza reinstallare il codice.

Base di conoscenza

Aiuterà, suggerirà, insegnerà. Inizia a digitare: l'elenco viene filtrato durante la digitazione.

smartbtn_widget_api.setContactInfo({
  name: "Alessio Morgan",
  email: "email@example.com",
  phone: "+17584987855",
  description: "Description text"
});

smartbtn_widget_api.setCustomData([
  {
    title: "Actions",
    content: "Add contact",
    link: "https://crm.example.com/contacts/new"
  },
  {
    content: "Open customer profile",
    link: "https://crm.example.com/customers/42"
  }
]);

curl -H "Authorization: Bearer <token>" https://<host>/api/v1/chats

// → { "data": [...], "next_cursor": "..." | null }

• Finestra PWA autonoma senza barra degli indirizzi del browser, con badge Dock e notifiche Web Push
• Accesso immediato a tutti gli strumenti: WhatsApp, Telegram, Instagram, Messenger, copilota AI, chatbot, richiamata, indicazioni stradali, prezzo
• Notifiche push per nuovi messaggi e richieste di richiamata
• Monitoraggio operatore, timer SLA e statistiche: direttamente nell'app

Contattaci

Hai una domanda o un suggerimento? Scrivici!

Dettagli dell'azienda

Dettagli dell'operatore per contratti e fatture.

Documenti legali

Termini di utilizzo del servizio e trattamento dei dati personali.