Integrazione Planfix

Integra SMSBAT con Planfix CRM per inviare messaggi Viber e SMS direttamente dalle attività e dalle chat di Planfix. Questa guida copre l'impostazione, la configurazione dei modelli e l'automazione della chat.

Panoramica

L'integrazione SMSBAT con Planfix ti permette di:

• Invia messaggi Viber e SMS ai clienti dalle attività Planfix
• Crea automaticamente attività dai messaggi di chat in arrivo
• Riapri le chat quando i clienti rispondono
• Tieni traccia dello stato di consegna dei messaggi all'interno di Planfix

Prerequisiti

• Un account SMSBAT attivo con credenziali API
• Un account Planfix con accesso amministratore
• Un modello di messaggio Viber Business approvato (per messaggi transazionali)

Passaggio 1: collega l'integrazione

1.1 Abilitare l'API Chat in Planfix

Passa a Gestione account > Integrazioni > Chat > API Chat Planfix nel tuo account Planfix.

Seleziona l'integrazione SMSBAT dall'elenco e abilitala.

1.2 Configurazione dei parametri di integrazione

Compila le impostazioni di integrazione con le credenziali fornite da SMSBAT:

Parametro	Descrizione
URL richiesta	L'URL fornito da SMSBAT per ricevere le richieste
Chiave di autorizzazione	La tua chiave di autorizzazione SMSBAT
Fornitore	smsbat
URL di notifica	L'URL del webhook per ricevere notifiche di consegna da Planfix, ad es. https://api.smsbat.com.ua/planfix/auth/uuid=...
IDProvider	smsbat
Chiave di autorizzazione Planfix	Chiave di autorizzazione lato Planfix
Modello attività	Seleziona il modello da utilizzare per creare attività con la chat
Modello di contatto	Seleziona il modello per la creazione di nuovi contatti

Ottenere credenziali

Contatta il supporto SMSBAT all'indirizzo help@smsbat.com per ricevere le credenziali di integrazione (URL di richiesta, chiave di autorizzazione e URL di notifica).

1.3 Impostazioni per la creazione delle attività

Configura il modo in cui Planfix gestisce i messaggi di chat in arrivo:

• Crea una nuova attività se non ci sono attività attive con questo contatto - Abilita questa opzione se il tuo flusso di lavoro prevede interazioni brevi o elaborazione dei lead in cui ogni richiesta dovrebbe creare una nuova attività.
• Se i tuoi cicli di vendita sono più lunghi o fornisci supporto continuo, è meglio riaprire le attività esistenti per conservare la cronologia completa delle conversazioni con il cliente.

Passaggio 2: configurazione del modello e dell'automazione della chat

2.1 Configurare il modello di saluto

Concordare con il cliente un modello di messaggio di saluto. Utilizza un modello di messaggio transazionale per avviare la chat, poiché è più conveniente rispetto a un messaggio promozionale.

2.2 Impostazione del modello di attività

Aggiungi il modello di messaggio di saluto approvato al modello di attività campo descrizione. Quando viene creata un'attività, il testo della descrizione verrà inviato al client come primo messaggio.

Esempio di configurazione del modello di attività:

Campo	Valore
Nome attività	"Richiesta commerciale Viber"
Telefono	Numero di telefono del cliente
Controparte	Controparte cliente
Descrizione	Il tuo modello di messaggio di auguri approvato

2.3 Flusso di lavoro delle interazioni rapide

Se il tuo flusso di lavoro prevede un'elaborazione rapida in cui non è necessario mantenere conversazioni lunghe:

1. Elaborare la richiesta di chat del cliente
2. Rispondi al cliente tramite la chat nell'attività
3. Imposta lo stato dell'attività su Completata
4. Quando il client invia un nuovo messaggio, una nuova attività verrà creata automaticamente (se la casella di controllo del passaggio 1.3 è abilitata)

2.4 Flusso di lavoro delle conversazioni in corso

Se non desideri creare un'attività separata per ogni messaggio del cliente, configura l'automazione della riapertura della chat.

2.4.1 Riaprire la chat tramite messaggio transazionale

Crea uno scenario di automazione che si attiva quando lo stato di un'attività cambia in Completato o Fine:

Scenario: "Riapri la chat"

Impostazione	Valore
Evento	Il valore del campo è cambiato
Campo	Avvia chat
Condizioni	Avvia chat = Sì AND Stato in (Completato, Fatto)
Logica del filtro	"1 E 2"

Azioni:

1. Aggiungi un commento con il modello del messaggio di saluto (notificando il contatto come destinatario)
2. Imposta il campo "Avvia chat" su selezionato
3. Aggiorna la data di completamento pianificata alla data corrente + 1 ora

2.4.2 Riapri la chat al nuovo commento

Crea scenari di automazione che riaprono la chat quando viene aggiunto un nuovo commento (da un lead/cliente o da un dipendente):

Scenario: "Riapri la chat (dipendente)"

Impostazione	Valore
Evento	Commento aggiunto condizioni di corrispondenza
Condizioni	Stato in (Completato, Fatto) AND Autore del commento = Dipendente
Logica del filtro	"1 E 2"

Azioni:

1. Cambia lo stato in In corso
2. Aggiorna la data di completamento pianificata alla data corrente + 1 ora
3. Aggiorna il nome dell'attività con il timestamp corrente e le informazioni sul client

Scenario: "Riapri chat (client)"

Impostazione	Valore
Evento	Commento aggiunto condizioni di corrispondenza
Condizioni	Stato in (Completato, Fatto) AND Autore del commento = Contatto
Logica del filtro	"1 E 2"

Azioni:

1. Cambia lo stato in Nuovo
2. Aggiorna la data di completamento pianificata alla data corrente + 1 ora
3. Aggiorna il nome dell'attività con il timestamp corrente e le informazioni sul client

Passaggio 3: invio di messaggi (notifiche lead)

Destinatari della notifica

Quando invii un commento (notifica a un lead), assicurati che il contatto (lead) sia selezionato come destinatario nell'elenco delle notifiche. Tieni presente che lo stato della casella di controllo può variare a seconda delle condizioni, quindi verificalo prima di inviare.

3.1 Casella di controllo deselezionata: il client non riceverà il messaggio

Se la casella di controllo del lead è deselezionata nell'elenco dei destinatari, il cliente non riceverà la notifica. Puoi usarlo per lasciare commenti interni visibili solo al tuo team.

3.2 Casella di controllo selezionata: il client riceverà il messaggio

Se la casella del lead è selezionata, il messaggio verrà inviato al cliente tramite Viber o SMS tramite SMSBAT.

3.3 Verifica della consegna dei messaggi

Controlla lo stato della consegna in Planfix

Fai clic sull'icona del segno di spunta accanto a un messaggio inviato per visualizzare il rapporto di consegna per tutti i destinatari di quel commento.

Verificare nel verbale di consegna

Il rapporto di consegna dovrebbe mostrare il cliente come destinatario con lo stato Inviato (senza stato di errore). Il report mostra la data, il canale (API Chat), il numero di telefono del destinatario e lo stato della consegna.

Migliori pratiche

Impostazione del modello

• Utilizza i modelli di messaggio transazionale per l'avvio della chat (più conveniente rispetto alla promozione)
• Mantieni i messaggi di saluto concisi e pertinenti
• Testare il modello con un piccolo gruppo prima di lanciarlo

Gestione delle attività

• Utilizza modelli di attività separati per diversi tipi di messaggi Viber Business
• Abilita la casella di controllo per la creazione automatica dell'attività se gestisci richieste brevi e una tantum
• Mantieni aperte le attività per le relazioni con i clienti in corso per preservare la cronologia della chat

Automazione

• Configura scenari di riapertura dei commenti dei dipendenti e dei clienti
• Utilizza le date di completamento pianificate per tenere traccia dello SLA
• Configura attentamente i destinatari delle notifiche per evitare messaggi indesiderati

Risoluzione dei problemi

I messaggi non vengono inviati

1. Verificare che le credenziali di integrazione siano corrette nelle impostazioni di Planfix
2. Verificare che il numero di telefono del contatto sia nel formato corretto
3. Assicurarsi che il lead sia selezionato come destinatario nell'elenco di notifiche dei commenti
4. Verificare che il modello di messaggio sia approvato

Le attività non vengono create automaticamente

1. Conferma che la casella di controllo "Crea una nuova attività se non ci sono attività attive" è abilitata
2. Verificare che il modello di attività sia configurato correttamente
3. Verificare che l'URL di notifica sia impostato correttamente

La chat non si riapre

1. Verificare che gli scenari di automazione siano attivi
2. Verificare che le condizioni di stato corrispondano agli stati del flusso di lavoro
3. Assicurati che il campo "Avvia chat" sia configurato correttamente

Passaggi successivi

• API SMSBAT - Informazioni sull'invio di messaggi tramite API
• Cascade API: imposta la consegna dei messaggi multicanale
• Tipi di messaggio - Esplora i tipi di messaggio disponibili
• Stato di consegna - Informazioni sugli stati di consegna