Introduzione

Le API forniscono la possibilità di integrare Aisac sia in lettura che in scrittura con il tuo sistema di ecommerce proprietario o per il quale non è stato ancora implementato un plugin

  • L'API di Aisac è basata su REST
  • Accetta richieste GET, POST, PUT, DELETE e PATCH codificate JSON.
  • Restituisce i valori codificati JSON.
  • Il fuso orario di riferimento è il CEST, che corrisponde all'orario UTC+2 quando è in vigore l'ora legale, o UTC+1 quando è in vigore l'ora solare.
Api Key Auth
Per poter utilizzare le API è necessario essere a conoscenza delle API Key private assegnate al/ai tuo/i canale/i, che si trovano sul Control Panel nella sezione: 
https://app.aisac.io/account/profile#api
Response
Le risposte sono in formato JSON.
Preliminari

Aisac per essere totalmente integrato e sviluppare i flussi operativi concordati deve avere due semplice endpoint su cui operare.

  • Un endpoint getObject su cui interrogheremo per recuperare l'oggetto attraverso paramentri concordati
  • Un ultimo endpoint updateObject su cui pusheremo l'update delle variabili.

Di seguito un esempio per la gestione dei flussi relativi ad un ecommerce.

GET_OBJECT

Request eseguita sul tuo WS

Response attesa dal tuo WS

UPDATE_OBJECT

Request eseguita sul tuo WS

Response attesa dal tuo WS

setRequest

Permette di creare le request in accordo con i propri Flow Operativi, attivi su Aisac. La request è l'oggetto alla quale saranno collegati tutti i successivi step

Request

Response

getRequest

Recupero di una request creata in precendenza.

Request

https://api.aisac.io/v1/getRequest?api_key=[TOKEN_KEY]&request_id=[REQUEST_ID]

Response

getRequests

Permette di recuperare un numero maggiore di richieste effettuate con diversi parametri

Request

Response

getFlowByUserKey

Recupera tutti i flussi operativi processati partendo da valore user_key

Request

https://api.aisac.io/v1/getFlowByUserKey?api_key=[TOKEN_KEY]&user_key=[user_key]

Response

getChargesByUserKey

Recupera tutti gli addebiti processati generati da user_key

Request

https://api.aisac.io/v1/getChargesByUserKey?api_key=[TOKEN_KEY]&user_key=[user_key]

Response

setOrder

Permette di creare ordini direttamente in Aisac se il tuo account è configurato per gestire Ordini.

Request

Response

WhatsApp Api Cloud

Le api ufficiali di WhatsApp ti garantiranno delle prestazioni ideali per ogni business.

Attenzione!
Tieni presente che non è possibile utilizzare il numero di telefono registrato nell'app WhatsApp Business o il tuo numero WhatsApp personale, che utilizzi per comunicare con amici e familiari. Avrai bisogno di un numero di telefono dedicato separato per l'API. Per ulteriori informazioni fare riferimento alla documentazione dell'API Could .

Per iniziare con WhatsApp Business Cloud, è necessario:
• Un account sviluppatore Facebook
• Un numero di cellulare valido.

Nota!
Prima di iniziare, comprendere le seguenti informazioni sui numeri di telefono:
[1] Il numero di telefono non deve essere registrato con il tuo account WhatsApp personale che utilizzi per comunicare con i tuoi amici e familiari. Se già registrato, elimina l'account esistente sul tuo cellulare per registrarti su WhatsApp Business Cloud.
[2] Non è possibile utilizzare contemporaneamente lo stesso numero di telefono sia sull'API on-premise che su quella cloud . È supportata solo una piattaforma alla volta con il numero di telefono. Vedi panoramica e numeri di telefono .
[3] Non violare i Termini e condizioni di WhatsApp: "Se utilizzi qualcosa di diverso dalla piattaforma ufficiale WhatsApp Business o da altri strumenti ufficiali di WhatsApp, ci riserviamo il diritto di limitare o rimuovere il tuo accesso a WhatsApp poiché ciò viola le nostre politiche. Ti preghiamo di non utilizzare alcun Strumenti di terze parti non autorizzati da WhatsApp per comunicare su WhatsApp. Consulta Utilizzo non autorizzato della messaggistica automatica o collettiva su WhatsApp per ulteriori informazioni".

Per connettere l'API WhatsApp Cloud a Make è necessario seguire i seguenti passaggi:
1. Configura l'API WhatsApp Cloud
2. Crea token di accesso permanente
3. Collega il tuo numero di telefono alle WA Cloud

    Configura l'API WhatsApp Cloud
  • Accedi al tuo account Facebook
  • Vai al sito degli sito degli sviluppatori di Facebook , fai clic su Le mie app > Crea app
  • Seleziona Business come tipo di app. Fare clic su Avanti
  • Inserisci il nome visualizzato e seleziona l'account aziendale. Fai clic su Crea app .
  • Quando richiesto, inserisci nuovamente la password del tuo account Facebook. Fare clic su Invia.L'app viene creata.Attenzione!
    In questo momento l'app non è ancora pronta per funzionare in modalità live perchè richiedere l'approvazione da parte di Meta sia della tua app che del tuo Business Manager se non è stato fatto. Per approfondire vai su Meta > Verifica dell'azienda
  • Nella dashboard dell'app, scorri verso il basso per trovare l'app WhatsApp e fai clic su Configura.
  • Seleziona il tipo di account e fai clic su Continua.
  • Copia l' ID dell'account WhatsApp Business in un luogo sicuro.
    Crea token di accesso permanente
  • Accedi al tuo account sviluppatore Facebook .
  • Fai clic su Dashboard delle app > Impostazioni aziendali .
  • Vai su Utenti di sistema > Aggiungi . Inserisci il nome utente, seleziona il ruolo di amministratore e fai clic su Crea utente di sistema .
  • Vai su Aggiungi risorse > App . Seleziona l'app che desideri assegnare all'utente, abilita l'accesso con controllo completo e fai clic su Salva modifiche
  • Vai su Account WhatsApp > Aggiungi persone > Seleziona l'utente del sistema > Abilita accesso con controllo completo > Assegna .
  • Vai a Utenti del sistema > Seleziona l'utente > Genera token di accesso .
  • Seleziona l'app, seguendo le autorizzazioni, quindi fai clic su Genera token .
    • whatsapp_business_messaging
    • whatsapp_business_management
  • Copia il token in un luogo sicuro.Puoi utilizzare questo token come token di accesso permanente.
    Collega il tuo numero di telefono alle WA Cloud
    Quando configuri l'API WhatsApp, viene creato un numero di prova per te. Puoi aggiungere il tuo numero
  • Accedi al tuo account sviluppatore Facebook .
  • Nella pagina Per iniziare, fai clic su Aggiungi numero di telefono.
  • Inserisci i dettagli del tuo profilo aziendale e fai clic su Avanti .Attenzione!
    Il nome che inserirai dovrà contenere il parzialmente il nome della tua azienda, questo per garantire un immediata approvazione.
    Nome azienda: Aisac srls -> "Assistanza Clienti e Spedizioni Aisac" oppure "Supporto spedizioni automatiche Aisac"
  • Inserisci il numero di telefono aziendale che desideri connettere all'API WhatsApp Business.Nota!
    Assicurati che il numero di telefono non sia registrato su WhatsApp prima. Se già registrato, elimina il tuo account WhatsApp con il numero prima di registrarti qui.
  • Scegli il metodo di verifica che preferisci ed inserisci il codice di verifica ricevuto sul tuo numero di telefono.
  • Inserisci i dettagli della tua attività e fai clic su Salva
  • Recupera adesso i valori del tuo ID Numero di Telefono, WhatsApp Business ID e salvale per uso futuro
    • Hai aggiunto con successo il tuo numero di telefono aziendale all'API WhatsApp Business Cloud.
    Configurazione del Webhook di Base
    Ultimo step necessario per far arrivare i tuoi messaggi al servizio di Aisac è configurare i webhook
  • Accedi al tuo account sviluppatore Facebook e vai nella sezione Webhook della tua app
  • Dal menu a tendina seleziona WhatsApp Business Account e registra l'oggetto
  • Inserisci il webhook di Asiac " https://app.aisac.io/webhook/facebook/ " (Inserire cosi come segnato compreso di slash finale) ed il token di verifica "abcd1234"
  • Sottoscrivere il singolo evento "messages" nella versione più recente Nota!
    Tutto questo è necessario per completare il collegamento.
Integrazione Shopify

Come collegare Shopify ad Aisac

Nota!
Prima di iniziare, comprendere le seguenti informazioni su account Shopify
[1] Shopify è una piattaforma con limitazioni di richieste per minuto per cui si rendono necessarie delle code di aggiornamento per garantire il funzionamento
[2] Con Aisac puoi collegare quanti store vuoi a patto di porre attenzione a gli id e le dovute variabili

Per permettere la creazione ricezione di un ordine su Aisac
1. Creazione di un Webhook
2. Set up App con permessi di Update
3. Variabili necessarie per Aisac

    Creazione di un Webhook
  • Accedi al tuo account Shopify
  • Vai al sito nella sezione setting all'url : https://admin.shopify.com/store/{store_url}/settings/general, fai clic su Setting > Notifiche
  • Seleziona la voce Webhooks
  • Seleziona dall'elenco la voce corrispondente a Order Creation, in modo da trasmettere immediatamente la creazione ad Aisac
  • Configura i i parametri come in foto ricordando che l'url del webhook è variabile https://api.aisac.io/webhook/shopify/?api_key={tua_api_key}&action=creation&id_store={tuo_id_store} e puoi trovarlo nel tuo account nella sezione Profilo > Shopify se abilitato.
    Creazione di un App con permessi necessari
  • Accedi al tuo account Shopify
  • Vai al sito nella sezione setting all'url : https://admin.shopify.com/store/{store_url}/settings/apps, fai clic su Setting > Apps and sales channels
  • Seleziona la voce Develop Apps
  • Seleziona la voce Crea App, assegnando un nome ed un developer
  • Seleziona gli scopi ed i permessi App
  • Installa la tua App
  • Visualizza e salva in un luogo sicuro il Access Token poichè ci servirà nel set up del nostro Store su Aisac
    Variabili necessarie per Aisac
  • Variabile SHOPIFY_TOKEN_APP disponibile dopo avere completato il punto precedente
  • Variabile SHOPIFY_STORE_NAME presente nell' url dopo avere effettuato l'accesso al tuo profilo Shopify https://admin.shopify.com/store/**********, è univoco ed è necessario per le operazioni di update