ERP APIs

Aggiornato il

Dove: Impostazioni > Integrazioni > ERP APIs

A cosa serve:

I tuoi sistemi gestionali mostrati come pulsanti accanto a ogni chat. Quando un operatore apre una conversazione, SyBox interroga il tuo sistema sul cliente e mostra il responso accanto alla chat, così l'operatore non deve mai uscire da SyBox. La risposta può contenere ordini, saldo, ticket o qualsiasi altro dato restituito dal tuo sistema. SyBox invia il numero di telefono del cliente, oppure il suo indirizzo email nelle conversazioni via email.

Sono disponibili tre tipi di ERP API:

  • "Scheda barra — mostra i dati accanto alla chat": un pulsante sulla barra laterale della casella di posta. Facendovi clic compaiono i dati del tuo sistema per il cliente aperto.
  • "Messaggio action — post a messaggio da its menu": una nuova voce nel menu di un messaggio WhatsApp in arrivo. L'operatore la seleziona, può modificare il testo e fa clic su Invia. SyBox invia quindi quel testo al tuo sistema. Il tuo sistema può rispondere "Fatto", mostrare un errore, porre all'operatore una domanda Sì/No o chiedergli di digitare una riga.
  • "Prodotti — cerca nel tuo catalogo e invia un elemento nella chat": l'operatore digita ciò che cerca il cliente. Il tuo sistema restituisce i prodotti corrispondenti, mostrati come schede con nome, prezzo, immagine e disponibilità. Un tocco inserisce il link del prodotto nella casella del messaggio.

Come aggiungere una ERP API

  1. Vai su Impostazioni > Integrazioni > ERP APIs.
    Settings, ERP APIs: a connected stock system that shows as a button in conversations
  2. Fai clic su "Aggiungi ERP API".
    The new ERP API window: its type first, then its name, button and address
  3. Scegli il "Tipo" (vedi i tre tipi sopra).
  4. Compila il campo "Display nome", ovvero il nome completo dell'integrazione.
  5. Compila il campo "Button nome", ovvero l'etichetta breve visibile sul pulsante o sulla voce di menu.
  6. Sotto "Icona pulsante", fai clic sull'icona desiderata per il pulsante.
  7. In "URL API ERP", incolla l'indirizzo del tuo sistema. Deve iniziare con http:// o https://.
  8. In "ERP token", incolla il token del tuo sistema, se richiesto. SyBox lo invierà con ogni richiesta per confermare al tuo sistema che la chiamata proviene effettivamente da te.
  9. Facoltativo: sotto "personalizzato headers", fai clic su "Aggiungi header" per inviare coppie nome/valore aggiuntive con ogni richiesta, ad esempio il codice di una filiale. Ogni intestazione ha il proprio interruttore di attivazione/disattivazione, per poterla sospendere senza eliminarla. Fai clic sull'icona del cestino per rimuovere un'intestazione. Alcuni nomi di intestazione utilizzati internamente da SyBox vengono ignorati.
  10. Fai clic su Salva.

Il nuovo pulsante compare immediatamente nella casella di posta. Non è necessario ricaricare la pagina.

Come modificare, mettere in pausa o eliminare una ERP API

  1. Trova la relativa scheda nell'elenco delle ERP APIs.
  2. Fai clic su Modifica per cambiare qualsiasi parametro. Per mantenere il token salvato, lascia vuoto il campo "ERP token" ("Leave blank a keep current").
    To edit, pause or delete an ERP API: "Edit" marked on the screen in SyBox
  3. Fai clic su Abilita / Disabilita per nascondere o mostrare il pulsante nella casella di posta. Una scheda disattivata è contrassegnata come "Disabilitato".
  4. Fai clic su Elimina, quindi conferma "Eliminare questa integrazione?".

Cosa mostra la scheda: il nome, il nome del pulsante, l'indirizzo e lo stato "Attivo" o "Disabilitato". Mostra "Nessun token" se non è presente alcun token salvato. Se è salvato un token, vengono mostrati solo i suoi ultimi caratteri.

Regole e messaggi:

  • "Display nome", "Button nome" e "URL API ERP" sono obbligatori. Se ne manca uno, compare il messaggio "Dati incompleti".
  • L'indirizzo deve iniziare con http:// o https://.

Sviluppo lato sistema: la Documentazione per sviluppatori pubblica di SyBox (sul sito web di SyBox, alla voce Sviluppatori) spiega cosa invia SyBox e come deve rispondere il tuo sistema. Sono inclusi i formati di visualizzazione, le righe cliccabili che aprono i dettagli di un singolo record e la ricerca dei prodotti.

Ho aggiunto una ERP API ma il pulsante non compare accanto alla chat.

Controlla che la scheda mostri lo stato "Attivo". Le tipologie "Scheda barra" o "Prodotti" corrispondono a un pulsante nella barra laterale della casella di posta. La tipologia "Messaggio action" non compare come pulsante laterale: compare nel menu contestuale di un messaggio WhatsApp in arrivo.

Il pannello si apre ma non mostra dati oppure restituisce un errore.

SyBox mostra qualsiasi risposta fornita dal tuo sistema. Verifica che l'indirizzo sia raggiungibile via Internet, che il token sia corretto e che il tuo sistema riesca a individuare il cliente tramite numero di telefono (o tramite indirizzo email nelle conversazioni via email).

Posso collegare più di un sistema?

Sì. Aggiungi tutte le ERP APIs di cui hai bisogno. Ognuna riceverà il proprio pulsante dedicato.

Chi può vedere i dati nel pannello?

I membri del team autorizzati ad aprire quella determinata conversazione nella casella di posta.