Configurazione HTTP request per invio RCS con Shopify Flow
In questa guida trovi un esempio di come configurare una HTTP request per inviare un RCS con Smshosting tramite i Flow di Shopify.
Se non sai come arrivare qui, guarda prima la guida sulla configurazione del flusso di lavoro.
HTTP method: POST
URL: https://api.smshosting.it/rest/api/rcs/message/send
Headers:
- Authorization: {{secrets.authorization-header-smsh}} (vedi configurazione flusso di lavoro)
- Content-Type: application/json
Body: JSON con tutti i parametri necessari (vedi i parametri che possono essere usati e a cosa servono nella documentazione).
Esempio di body per l'invio di un RCS:
{"to": "393480000000", "agentId": "xxxx", "fallbackSms": false, "contentMessage": "{\"contentMessage\":{\"text\":\"Testo RCS\",\"suggestions\":[]}}"}
Per ottenere il contentMessage puoi creare un nuovo modello sulla piattaforma Smshosting
Si aprirà quindi l'editor dove sarà possibile configurare l'RCS che verrà inviato
Una volta configurato il tutto, sulla pagina del modello sarà possibile trovare il contentMessage:
Ovviamente, il body può essere dinamico utilizzando le variabili di Shopify che cambieranno automaticamente con i valori del carrello, ordine, cliente, ecc.
Per aggiungere una variabile Shopify all'interno del body, basta posizionare il cursore nel punto dove la si vuole inserire e premere il tasto “Aggiungi Variabile”.
Per esempio, se nel "to" vuoi che venga inserito il numero del cliente al quale appartiene il carrello, dovrai spostare il cursore dove vuoi inserire la variabile e poi premere su “Aggiungi variabile”
Potrai quindi selezionare il valore che più sembra corretto cercando tra le moltissime possibilità che vengono offerte da Shopify (in questo caso voglio il numero del cliente).
Questo inserirà la variabile Shopify nel body
{"to": "{{customer.lastOrder.phone}}", "agentId": "xxxx", "fallbackSms": false, "contentMessage": "{\"contentMessage\":{\"text\":\"Testo RCS\",\"suggestions\":[]}}"}
e quando verrà eseguito il flow, il placeholder {{customer.lastOrder.phone}} verrà automaticamente sostituito con il numero del cliente in fase di invio.
Potrai fare lo stesso per tantissime altre cose, come per esempio aggiungere al text del messaggio il nome del cliente, il numero dell'ordine e molto altro.