OneTrace.pro Centro assistenza

Integrazioni e canali

Un'integrazione è il collegamento di OneTrace.pro a un servizio esterno: server di posta, gateway SMS, bot di messaggistica, piattaforma pubblicitaria o storage di file. Attraverso i canali collegati funzionano i percorsi e le campagne, attraverso le destinazioni le esportazioni dei pubblici e le conversioni pubblicitarie, attraverso le sorgenti l'importazione periodica dei dati.

La sezione si apre dal menu Coinvolgimento → Integrazioni.

Pagina «Integrazioni» con i canali collegati

Le integrazioni collegate sono raggruppate per tipo. Quando i tipi sono più di uno, sopra le schede compare un filtro con i contatori: Tutte, Canali, CRM e così via.

Cosa si può collegare

Una nuova integrazione si collega con il pulsante Aggiungi integrazione: nella finestra i servizi sono suddivisi per tipo e la ricerca trova un servizio per nome. Il pulsante + accanto al titolo di un gruppo nella pagina apre la finestra direttamente su quel tipo.

Canali: servono a inviare i messaggi.

Canale Come funziona
Email Servizio di posta della piattaforma: invio dal Suo dominio collegato in Domini di invio, con firma DKIM, rimbalzi, reclami e lista di soppressione gestiti automaticamente; oppure Server SMTP proprio: indirizzo, porta, crittografia, nome utente e password. In entrambi i casi si indicano indirizzo e nome del mittente ed è possibile attivare il tracciamento di aperture e clic. Con un server SMTP proprio è possibile indicare il dominio e la casella dei rimbalzi, in modo che le email non consegnate disiscrivano automaticamente l'indirizzo. Le email dei clienti all'indirizzo di assistenza possono arrivare nella chat online, vedi Email in arrivo nella chat
SMS provider a scelta: SMS.ru, SMSC.ru, Twilio o l'API HTTP del Suo gateway. Gli stati di consegna arrivano all'indirizzo mostrato nell'integrazione
Telegram un bot creato in BotFather: basta il token, l'indirizzo per i messaggi in arrivo viene configurato automaticamente
Viber (messaggi aziendali) messaggi al numero di telefono tramite un aggregatore: SMSC.ru, Infobip o la Sua API HTTP
Bot Viber un bot Viber tramite il token del pannello partner, con un messaggio di benvenuto per i nuovi iscritti
Bot MAX un bot dell'app di messaggistica MAX tramite il token di business.max.ru, con un messaggio di benvenuto e il pulsante «Condividi il numero», vedi Bot MAX
Community VK messaggi a nome della community tramite chiave di accesso, dal piano «Crescita», vedi Community VK
Instagram Direct messaggi dall'account business di Instagram tramite la Sua app Meta, dal piano «Crescita», vedi Instagram Direct
Facebook Messenger messaggi dalla pagina Facebook tramite la Sua app Meta, dal piano «Crescita», vedi Facebook Messenger
WhatsApp WhatsApp Business Cloud API: ID del numero, ID dell'account, token e secret dell'app Meta
Web Push notifiche nel browser; le chiavi vengono create automaticamente e le iscrizioni vengono raccolte dal codice sul sito, vedi Collegamento del sito
Push mobile notifiche nell'app per Android e iOS: pacchetto e account di servizio Firebase, bundle id e chiave APNs, vedi App mobili
Messaggi in-app finestra, banner o schermo intero all'interno dell'app aperta; dal piano «Crescita», vedi App mobili
Carte Wallet carta fedeltà in Apple Wallet e Google Wallet: certificato Pass Type ID di Apple, Issuer ID e account di servizio Google; dal piano «Crescita», vedi Carte Wallet
Webhook una richiesta al Suo server con i dati del messaggio, ad esempio per un Suo sistema di notifiche

Esportazione dei pubblici: Webhook, S3 (CSV), Meta Custom Audience, Yandex Audiences, VK Ads e Google Ads Customer Match.

Conversioni pubblicitarie: Meta Conversions API, conversioni offline di Yandex Metrica e Google Ads, eventi offline di VK Ads (vedi Conversioni pubblicitarie).

Sorgenti di dati: file tramite URL, file da S3 e foglio Google.

Data warehouse: S3 (NDJSON), Google Cloud Storage, BigQuery, Snowflake, ClickHouse e PostgreSQL per l'esportazione dei dati del progetto. Il gruppo è visibile con il piano «Enterprise».

CRM: amoCRM, Kommo, Bitrix24, HubSpot, Pipedrive, Zoho CRM, Odoo, Salesforce e Microsoft Dynamics 365: contatti, lead e trattative nei profili e negli eventi, nodi dei percorsi per trattative e attività, esportazione dei segmenti verso il CRM, vedere CRM. Il gruppo è visibile dal piano «Crescita».

È possibile collegare più integrazioni dello stesso tipo: ad esempio due server SMTP per le email di marketing e per quelle transazionali. In modelli, percorsi e campagne si sceglie tramite quale integrazione inviare.

Come collegare un'integrazione

  1. Faccia clic su Aggiungi integrazione e scelga un servizio, ad esempio Email. A sinistra nella finestra ci sono i tipi di integrazione con una spiegazione, in alto la ricerca per nome.
  2. Assegni un Nome: lo vedrà in modelli, percorsi ed esportazioni, ad esempio «Email marketing».
  3. Compili le impostazioni. I suggerimenti sotto i campi spiegano dove trovare il token o la chiave nel pannello del servizio.
  4. Faccia clic su Salva. Per scegliere un altro servizio, faccia clic su Indietro.
  5. Nella scheda dell'integrazione faccia clic su Verifica.

Finestra «Nuova integrazione»: tipi di integrazione, ricerca e servizi

Finestra di collegamento dell'integrazione Email

Per alcuni servizi, dopo il salvataggio compaiono nelle impostazioni dei campi tecnici, ad esempio URL del webhook e Token di verifica per WhatsApp o URL degli stati di consegna per gli SMS. Li copi nel pannello del servizio, altrimenti stati di consegna e messaggi in arrivo non verranno ricevuti.

Telegram, Bot Viber, Bot MAX e WhatsApp ricevono i messaggi in arrivo all'indirizzo della Sua installazione di OneTrace.pro, che deve essere raggiungibile da Internet tramite HTTPS.

Bot MAX

  1. Crei un bot su business.max.ru (possono pubblicare un bot solo una persona giuridica russa, un imprenditore individuale o un lavoratore autonomo) e copi il token: «Чат-боты» → ⋮ → «Настройки».
  2. Faccia clic su Aggiungi integrazione, scelga Bot MAX, incolli il Token del bot e salvi. L'indirizzo per i messaggi in arrivo viene configurato automaticamente e il nome del bot compare nelle impostazioni.
  3. Se lo desidera, imposti il Messaggio di benvenuto e il testo del pulsante «Condividi il numero»: il bot li invia quando il cliente lo avvia.

Finestra di collegamento del bot MAX

Il bot può scrivere solo a chi lo ha avviato. Il cliente viene collegato al profilo in due modi:

  • tramite link: il Suo server crea per il cliente che ha effettuato l'accesso il link https://max.ru/{bot}?start=… (POST /api/v1/max/link, come per Telegram) e il cliente apre il bot tramite questo link;
  • tramite numero: il cliente preme il pulsante «Condividi il numero» nel messaggio di benvenuto. Se MAX conferma che il numero appartiene al suo account, il bot viene collegato al profilo con questo telefono. Una scheda contatto altrui inoltrata non viene collegata.

L'avvio del bot è un'iscrizione al canale; l'arresto del bot o l'eliminazione della conversazione è una disiscrizione. I messaggi dei clienti al bot diventano l'evento max.message e, dal piano «Crescita», conversazioni della chat online. MAX non fornisce rapporti di consegna: un messaggio accettato è considerato consegnato. Le regole di MAX vietano la pubblicità nei messaggi di servizio.

Community VK

  1. Nella community apra Manage → Messages e attivi i messaggi della community.
  2. In Manage → API usage → Access tokens faccia clic su «Create token» e selezioni i permessi «Community management», «Community messages», «Photos» e, se le regole dovranno rispondere ai commenti, «Wall».
  3. Faccia clic su Aggiungi integrazione, scelga Community VK, incolli la Chiave di accesso della community e salvi. OneTrace.pro verifica i permessi della chiave, aggiunge da sé il server Callback API nelle impostazioni della community e mostra il nome e l'indirizzo della community.
  4. Se lo desidera, imposti il Messaggio di benvenuto: lo riceve chi ha consentito i messaggi della community.

Finestra di collegamento della community VK

La community può scrivere solo a chi ha consentito i messaggi: ha scritto per primo, ha premuto «Allow messages» o ha aperto un link vk.me. Questa è l'iscrizione al canale, mentre il divieto dei messaggi è una disiscrizione. Il Suo server può collegare la persona al profilo del cliente: POST /api/v1/vk/link crea per il cliente che ha effettuato l'accesso il link https://vk.me/{community}?ref=…, e la stessa etichetta si può passare come chiave al widget «Allow messages».

Nel messaggio si possono inviare testo, un'immagine e pulsanti con link. VK non accetta immagini tramite URL: OneTrace.pro carica il file da sé, una volta per campagna. I messaggi delle persone diventano l'evento vk.message e conversazioni della chat online, mentre i commenti ai post attivano le regole per parole chiave. L'eliminazione dell'integrazione rimuove anche il server Callback API dalle impostazioni della community.

Instagram Direct

Instagram si collega tramite la Sua app in Meta: per il proprio account la revisione dell'app da parte di Meta non è necessaria.

  1. In Meta for Developers crei un'app, aggiunga il prodotto Instagram e nella sezione Configurazione dell’API con accesso tramite Instagram colleghi l'account business.
  2. Faccia clic su «Genera token di accesso» e copi il token. Servono le autorizzazioni instagram_business_basic, instagram_business_manage_messages e, per rispondere ai commenti, instagram_business_manage_comments. Nella stessa sezione copi la Chiave segreta dell’app Instagram.
  3. Faccia clic su Aggiungi integrazione, scelga Instagram Direct, incolli il token e la chiave segreta e salvi. Nelle impostazioni compariranno URL del webhook e Token di verifica.
  4. Inserisca l'URL e il token nelle impostazioni dei webhook dell'app (sezione Instagram). OneTrace.pro iscriverà da sé l'account agli eventi.

Finestra di collegamento di Instagram Direct

Il token dura 60 giorni e OneTrace.pro lo rinnova da sé. Se il rinnovo non riesce, l'errore compare sulla scheda dell'integrazione: crei un nuovo token e salvi l'integrazione prima che il vecchio scada.

Instagram consente di scrivere a una persona solo entro 24 ore dal suo messaggio. Campagne e percorsi saltano chi ha scritto prima: il messaggio non parte e l'iscrizione resta. Un operatore della chat può rispondere anche più tardi, fino a 7 giorni, se l'app ha l'autorizzazione Human Agent e nell'integrazione è attivo Risposte degli operatori fino a 7 giorni.

Il primo messaggio della persona è l'iscrizione al canale, «stop» è la disiscrizione. Il link alla conversazione con un'etichetta per il collegamento al profilo viene creato da POST /api/v1/instagram/link: https://ig.me/m/{account}?ref=…. I messaggi e le risposte alle storie diventano l'evento instagram.message e conversazioni della chat online, mentre i commenti attivano le regole per parole chiave.

Facebook Messenger

Messenger si collega tramite la Sua app in Meta, come Instagram: per la propria pagina la revisione dell'app da parte di Meta non è necessaria.

  1. In Meta for Developers crei un'app e aggiunga il prodotto Messenger.
  2. Nella sezione Messenger → Impostazioni API colleghi la pagina Facebook e crei un token della pagina con l'autorizzazione pages_messaging. Serve un token senza scadenza: OneTrace.pro non lo rinnova. In Impostazioni app → Di base copi il segreto dell’app.
  3. Faccia clic su Aggiungi integrazione, scelga Facebook Messenger, incolli il token e il segreto e salvi. OneTrace.pro troverà la pagina, la iscriverà ai messaggi e mostrerà Indirizzo del webhook e Token di verifica.
  4. Inserisca l'indirizzo e il token nelle impostazioni dei webhook dell'app (sezione Messenger).

Messenger, come Instagram, consente di scrivere a una persona solo entro 24 ore dal suo messaggio: campagne e percorsi saltano chi ha scritto prima. Un operatore della chat può rispondere fino a 7 giorni, se l'app ha l'autorizzazione Human Agent e nell'integrazione è attivo Risposte degli operatori fino a 7 giorni.

Il primo messaggio della persona è l'iscrizione al canale e attiva il Messaggio di benvenuto delle impostazioni dell'integrazione, «stop» è la disiscrizione. Nel profilo la persona riceve l'identificatore facebook_psid, il numero della conversazione proprio con la Sua pagina, e il nome da Facebook, se la pagina lo vede. Messaggi, foto e file diventano l'evento messenger.message e conversazioni della chat online. I pulsanti di risposta rapida dell'operatore arrivano in Messenger come veri pulsanti.

Email in arrivo nella chat

Nell'integrazione email il gruppo Email in arrivo nella chat riceve nella chat online le email che i clienti inviano all'indirizzo di assistenza. La risposta dell'operatore parte tramite la stessa integrazione nella stessa conversazione. Modalità:

  • Casella IMAP: server, porta, crittografia, login, password e cartella della casella di assistenza. Le nuove email vengono lette una volta al minuto e contrassegnate come lette.
  • Webhook: dopo il salvataggio compare l'Indirizzo del webhook con un token. Lo indichi nel servizio di posta come indirizzo per le email in arrivo. Sono adatti: Postmark con Inbound webhook, SendGrid con Inbound Parse, con o senza «POST the raw, full MIME message», Mailgun con Routes e l'azione forward, Cloudflare Email Workers con l'inoltro dell'email completa. Il token nell'indirizzo è segreto: non pubblichi l'indirizzo. Se l'indirizzo potrebbe essere finito in mani altrui, selezioni Cambia l'indirizzo del webhook e salvi: comparirà un nuovo indirizzo e quello precedente non accetterà più email. L'indirizzo lo vede solo chi può gestire l'integrazione.

L'Indirizzo di assistenza è obbligatorio per entrambe le modalità: è l'indirizzo a cui scrivono i clienti ed è anche l'indirizzo di risposta nelle email degli operatori.

Verifica e stati

Il pulsante Verifica si collega al servizio e mostra il risultato: «La connessione funziona» con i dettagli (nome del bot, saldo del provider SMS, bucket disponibile) oppure «La verifica non è riuscita» con il testo dell'errore. L'ora dell'ultima verifica è indicata sulla scheda.

Stato Significato
Attiva la connessione è in ordine
Errore l'ultima verifica o configurazione non è riuscita; il testo dell'errore è sulla scheda. Corregga le impostazioni e verifichi di nuovo
Disattivata l'integrazione è stata disattivata con l'interruttore Attiva nelle impostazioni; tramite essa non vengono inviati messaggi

La verifica degli SMS tramite la Sua API HTTP controlla solo che l'indirizzo del gateway sia raggiungibile: un SMS reale è a pagamento, quindi verifichi l'invio con un messaggio di prova dal modello.

Modifica ed eliminazione

  • Modifica apre le impostazioni. Password, token e chiavi non vengono mostrati dopo il salvataggio: lasci il campo vuoto per mantenere il valore precedente.
  • Per sospendere temporaneamente gli invii, disattivi l'interruttore Attiva: le impostazioni restano salvate.
  • Elimina integrazione: i messaggi non verranno più inviati tramite essa, e le esportazioni e le sorgenti che usano questa connessione si fermeranno con un errore. Per i bot Telegram, Viber e MAX e per SMS.ru la piattaforma rimuove da sé il proprio webhook. Se il servizio non è raggiungibile, comparirà un avviso: rimuova il webhook manualmente nelle impostazioni del bot o nell'account del servizio.

Chi può gestire le integrazioni

Azione Ruoli
Vedere le integrazioni «Proprietario», «Amministratore», «Manager»
Collegare, modificare, verificare ed eliminare «Proprietario», «Amministratore»

Il ruolo di un membro può essere limitato a singole integrazioni, vedi Membri e ruoli. Un membro di questo tipo vede nella sezione solo le proprie integrazioni e gestisce solo quelle, se il ruolo lo consente. Non può collegare una nuova integrazione: serve un permesso sull'intero progetto. Negli editor di modelli e percorsi continua comunque a scegliere l'integrazione tra tutte quelle collegate nel progetto.

Da sapere

  • I canali non verificano da soli iscrizioni e frequenza: queste regole sono comuni a tutti i canali e si impostano nella pagina Regole di invio.
  • Nella stessa pagina è possibile disattivare un'estensione non necessaria, ad esempio WhatsApp. Un'estensione disattivata scompare da integrazioni, modelli e percorsi del progetto.
  • Il primo messaggio su WhatsApp e gli invii massivi sono possibili solo con modelli approvati da Meta; il testo libero è consentito entro 24 ore dal messaggio del cliente. Modelli Meta, caroselli di prodotti e moduli WhatsApp sono descritti nell'articolo Acquisti su WhatsApp.
  • Con il servizio di posta della piattaforma, i record DKIM, SPF e dei rimbalzi si aggiungono una sola volta, quando si collega il dominio: vedi Domini di invio. Per un server SMTP proprio, SPF, DKIM e DMARC si configurano sul server e sul Suo dominio.