L'integrazione consente di gestire le richieste dei clienti che scrivono all'account WeChat ufficiale della tua azienda.
Che cos'è un Account di servizio WeChat?
Un Account di servizio WeChat è un account aziendale ufficiale su WeChat. I clienti possono trovarlo, seguirlo e inviargli messaggi proprio come farebbero con una chat dal vivo su un sito web. L'integrazione non supporta l'invio di messaggi ai clienti da un account WeChat personale. Tutte le comunicazioni avvengono per conto dell'azienda tramite il suo Account di servizio.
Come funziona
- Un cliente invia un messaggio al tuo Account di servizio.
- Planfix crea automaticamente una scheda contatto e un compito per la nuova conversazione.
- Un dipendente risponde aggiungendo un commento al compito e selezionando il cliente nelle notifiche del commento.
- Il cliente riceve la risposta su WeChat dall'account della tua azienda.
- La conversazione può proseguire nel rispetto delle limitazioni di WeChat (vedi sotto).
I dipendenti gestiscono le conversazioni da un'unica interfaccia Planfix, mentre i clienti continuano a usare WeChat.
Cosa sapere prima di collegare l'integrazione
WeChat impone limiti rigorosi alle comunicazioni tra aziende e utenti:
- Non puoi avviare una conversazione con un cliente. Il cliente deve inviare il primo messaggio al tuo Account di servizio.
- Puoi inviare al massimo 5 risposte per ogni messaggio ricevuto dal cliente.
- Puoi rispondere solo entro 48 ore dall'ultimo messaggio del cliente. Le risposte inviate dopo questo periodo non verranno recapitate.
- I file diversi dalle immagini vengono inviati come link. Le immagini vengono inviate come immagini, mentre gli altri allegati vengono recapitati ai clienti come link ai file.
Se viene raggiunto il limite di messaggi o scade il periodo di 48 ore, la risposta non verrà recapitata al cliente.
A chi è destinata
- Team di assistenza clienti che gestiscono le richieste tramite l'account WeChat ufficiale dell'azienda.
- Team che rispondono alle domande su prodotti e servizi.
- Aziende che gestiscono le richieste ricevute su WeChat insieme agli altri canali di comunicazione, tramite una pipeline condivisa.
Cosa serve per collegare l'integrazione
- Autorizzazioni di amministratore nel tuo account Planfix.
- Accesso alla piattaforma per sviluppatori WeChat con autorizzazioni per gestire l'Account di servizio richiesto.
- "AppID" e "AppSecret" del tuo Account di servizio WeChat.
- Un "Token" e una "EncodingAESKey", da configurare durante la procedura (vedi i passaggi seguenti).
- Modelli di compito e contatto che Planfix utilizzerà per creare compiti per le nuove conversazioni con i clienti e schede contatto.
Passaggio 1. Recupera AppID e AppSecret in WeChat
AppID e AppSecret sono rispettivamente l'identificativo e la chiave segreta del tuo Account di servizio. Planfix li usa per collegarsi a WeChat:
- Apri la piattaforma per sviluppatori WeChat e accedi con WeChat.
- Fai clic su "Go to Console".
- Vai a "My Business" — "Service Account".
- Apri l'Account di servizio che vuoi collegare.
- Copia "AppID" e "AppSecret" dai dettagli dell'account.
Importante: WeChat non conserva né mostra il tuo AppSecret precedente. Se lo perdi, dovrai reimpostare la chiave. Dopo la reimpostazione, il vecchio AppSecret non funzionerà più. Aggiornalo subito in Planfix e in tutti gli altri sistemi in cui è utilizzato.
Passaggio 2. Crea una connessione in Planfix
- In Planfix, vai a Gestione account — Integrazioni — Chat — WeChat.
- Fai clic su "Aggiungi account".
- Copia il valore dal campo "URL richiesta". Questo è l'URL webhook a cui WeChat invierà messaggi ed eventi. Ti servirà nel passaggio 3.
- Compila i campi rimanenti:
- Nome — Inserisci un nome qualsiasi per la connessione (ad esempio, "WeChat — Assistenza").
- AppId — Inserisci l'AppID di WeChat.
- AppSecret — Inserisci l'AppSecret di WeChat.
- Token — Crea una stringa composta da lettere latine e numeri (fino a 32 caratteri). Nel passaggio 3 dovrai inserire in WeChat esattamente lo stesso valore.
- EncodingAESKey — La chiave di crittografia dei messaggi. Inserisci una chiave a tua scelta oppure generane una in WeChat nel passaggio 3 e incollala qui. I valori in Planfix e WeChat devono corrispondere.
- Salva l'integrazione.
Importante: salva l'integrazione in Planfix prima di verificare l'URL in WeChat. In caso contrario, la verifica di WeChat non andrà a buon fine.
Passaggio 3. Configura i messaggi in arrivo in WeChat
Indica a WeChat dove inviare i messaggi:
- Apri il tuo Account di servizio nella piattaforma per sviluppatori WeChat.
- Vai alle impostazioni del dominio e delle notifiche push.
- Fai clic su "Enable" accanto a Push Notifications.
- Nel campo "URL", incolla l'"URL richiesta" copiato da Planfix nel passaggio 2.
- Nel campo "Token", inserisci lo stesso Token configurato in Planfix.
- Nel campo "EncodingAESKey", inserisci la stessa chiave configurata in Planfix (oppure genera qui una chiave casuale e copiala in Planfix).
- Seleziona "XML" come formato dei dati.
- Seleziona "Secure Mode" come modalità di crittografia.
- Salva le impostazioni.
Quando salvi le impostazioni, WeChat invia una richiesta di verifica all'URL di Planfix. Planfix verifica la firma usando il Token e restituisce una conferma. Se la verifica riesce, WeChat inizierà a inviare messaggi ed eventi a Planfix.
Verifica la connessione
Per assicurarti che tutto funzioni:
- Invia un messaggio all'Account di servizio collegato da un account WeChat utente normale.
- In Planfix dovrebbe apparire un nuovo compito per la conversazione.
- Dovrebbe essere creata una nuova scheda contatto oppure il compito dovrebbe essere collegato a un contatto esistente.
- Aggiungi un commento al compito e seleziona il cliente nelle notifiche del commento.
- Il cliente dovrebbe ricevere la tua risposta su WeChat.
Se la connessione non funziona
Controlla che:
- L'integrazione sia stata salvata in Planfix prima di verificare l'URL in WeChat.
- L'URL sia stato copiato per intero e inizi con
https://. - I valori di Token in Planfix e WeChat corrispondano e non contengano spazi aggiuntivi.
- I valori di EncodingAESKey in Planfix e WeChat corrispondano.
- Come formato dei dati sia selezionato XML.
- AppID e AppSecret appartengano allo stesso Account di servizio.
- L'AppSecret non sia stato reimpostato o bloccato in WeChat.
- Se in WeChat è attiva una whitelist di IP per l'API, assicurati che non blocchi l'accesso da Planfix.
Limitazioni
Quando usi l'integrazione, si applicano le seguenti regole di WeChat:
- Non puoi avviare una conversazione con un utente. Solo il cliente può iniziare la conversazione.
- I messaggi possono essere inviati solo per conto dell'Account di servizio dell'azienda. Gli account WeChat personali non sono supportati.
- Puoi inviare al massimo 5 risposte dopo ogni messaggio ricevuto dal cliente.
- Puoi rispondere solo entro 48 ore dall'ultimo messaggio del cliente.
- Le immagini vengono inviate come immagini; gli altri file vengono inviati come link.
- Sono supportati solo i messaggi XML.
- I messaggi inviati da Planfix sono soggetti alle regole di WeChat per i messaggi del servizio clienti.