Intégration Planfix
Intégrez SMSBAT à Planfix CRM pour envoyer des messages Viber et SMS directement à partir des tâches et des discussions Planfix. Ce guide couvre l'installation, la configuration des modèles et l'automatisation du chat.
Aperçu
L'intégration SMSBAT avec Planfix vous permet de :
- Envoyez des messages Viber et SMS aux clients à partir des tâches Planfix
- Créez automatiquement des tâches à partir des messages de discussion entrants
- Rouvrir les discussions lorsque les clients répondent
- Suivre l'état de livraison des messages dans Planfix
Prérequis
- Un compte SMSBAT actif avec les identifiants API
- Un compte Planfix avec accès administrateur
- Un modèle de message Viber Business approuvé (pour les messages transactionnels)
Étape 1 : Connecter l'intégration
1.1 Activer l'API de chat dans Planfix
Accédez à Gestion de compte > Intégrations > Chats > API Planfix Chat dans votre compte Planfix.
Sélectionnez l'intégration SMSBAT dans la liste et activez-la.

1.2 Configurer les paramètres d'intégration
Remplissez les paramètres d'intégration avec les identifiants fournis par SMSBAT :
| Paramètre | Descriptif |
|---|---|
| URL de demande | L'URL fournie par SMSBAT pour recevoir les requêtes |
| Clé d'autorisation | Votre clé d'autorisation SMSBAT |
| Fournisseur | smsbat |
| URL de notification | L'URL du webhook pour recevoir les notifications de livraison de Planfix, par ex. https://api.smsbat.com.ua/planfix/auth/uuid=... |
| Identifiant du fournisseur | smsbat |
| Clé d'autorisation Planfix | Clé d'autorisation côté Planfix |
| Modèle de tâche | Sélectionnez le modèle à utiliser pour créer des tâches avec chat |
| Modèle de contact | Sélectionnez le modèle pour créer de nouveaux contacts |

Obtenir les informations d'identification
Contactez l'assistance SMSBAT à help@smsbat.com pour recevoir vos informations d'identification d'intégration (URL de demande, clé d'autorisation et URL de notification).
1.3 Paramètres de création de tâches
Configurez la manière dont Planfix gère les messages de discussion entrants :
- Créez une nouvelle tâche s'il n'y a aucune tâche active avec ce contact - Activez cette option si votre flux de travail implique de courtes interactions ou un traitement de leads où chaque demande doit créer une nouvelle tâche.
- Si vos cycles de vente sont plus longs ou si vous fournissez un support continu, il est préférable de rouvrir les tâches existantes pour conserver l'historique complet des conversations avec le client.

Étape 2 : configuration du modèle et de l'automatisation du chat
2.1 Configurer le modèle de message d'accueil
Convenez d'un modèle de message de bienvenue avec le client. Utilisez un modèle de message transactionnel pour lancer le chat, car il est plus rentable qu'un message promotionnel.
2.2 Configurer le modèle de tâche
Ajoutez le modèle de message de bienvenue approuvé au champ de description du modèle de tâche. Lorsqu'une tâche est créée, le texte de la description sera envoyé au client comme premier message.
Exemple de configuration de modèle de tâche :
| Champ | Valeur |
|---|---|
| Nom de la tâche | Demande commerciale Viber |
| Téléphone | Numéro de téléphone du client |
| Contrepartie | Contrepartie client |
| Description | Votre modèle de message de bienvenue approuvé |

2.3 Flux de travail des interactions rapides
Si votre flux de travail implique un traitement rapide où vous n'avez pas besoin d'entretenir de longues conversations :
- Traitez la demande de chat du client
- Répondez au client via le chat dans la tâche
- Définissez le statut de la tâche sur Terminé
- Lorsque le client envoie un nouveau message, une nouvelle tâche sera créée automatiquement (si la case à cocher de l'étape 1.3 est activée)
2.4 Flux de travail des conversations en cours
Si vous ne souhaitez pas créer une tâche distincte pour chaque message client, configurez l'automatisation de la réouverture du chat.
2.4.1 Rouvrir le chat via un message transactionnel
Créez un scénario d'automatisation qui se déclenche lorsque le statut d'une tâche passe à Terminé ou Terminé :
Scénario : « Réouvrir le chat »
| Paramètre | Valeur |
|---|---|
| Événement | Valeur du champ modifiée |
| Champ | Démarrer le chat |
| Conditions | Démarrer le chat = Oui ET Statut dans (Terminé, Terminé) |
| Logique de filtre | 1 ET 2 |
Actions :
- Ajoutez un commentaire avec le modèle de message d'accueil (notifiant le contact comme destinataire)
- Définissez le champ « Démarrer le chat » sur coché
- Mettez à jour la date d'achèvement prévue à la date actuelle + 1 heure

2.4.2 Rouvrir le chat sur un nouveau commentaire
Créez des scénarios d'automatisation qui rouvrent le chat lorsqu'un nouveau commentaire est ajouté (soit d'un prospect/client, soit d'un employé) :
Scénario : « Réouvrir le chat (employé) »
| Paramètre | Valeur |
|---|---|
| Événement | Commentaire ajouté conditions correspondantes |
| Conditions | Statut dans (Terminé, Terminé) ET Auteur du commentaire = Employé |
| Logique de filtre | 1 ET 2 |
Actions :
- Changez le statut en En cours
- Mettre à jour la date d'achèvement prévue à la date actuelle + 1 heure
- Mettre à jour le nom de la tâche avec l'horodatage actuel et les informations sur le client

Scénario : « Réouvrir le chat (client) »
| Paramètre | Valeur |
|---|---|
| Événement | Commentaire ajouté conditions correspondantes |
| Conditions | Statut dans (Terminé, Terminé) ET Auteur du commentaire = Contact |
| Logique de filtre | 1 ET 2 |
Actions :
- Changez le statut en Nouveau
- Mettre à jour la date d'achèvement prévue à la date actuelle + 1 heure
- Mettre à jour le nom de la tâche avec l'horodatage actuel et les informations sur le client

Étape 3 : Envoi de messages (notifications de prospects)
Destinataires des notifications
Lors de l'envoi d'un commentaire (notification d'un prospect), assurez-vous que le contact (lead) est coché comme destinataire dans la liste de notification. Notez que l'état de la case à cocher peut varier en fonction des conditions, alors vérifiez-le avant d'envoyer.
3.1 Case décochée - Le client ne recevra pas le message
Si la case du prospect n'est pas cochée dans la liste des destinataires, le client ne recevra pas la notification. Vous pouvez l'utiliser pour laisser les commentaires internes visibles uniquement à votre équipe.

3.2 Case cochée - Le client recevra le message
Si la case du prospect est cochée, le message sera envoyé au client via Viber ou SMS via SMSBAT.

3.3 Vérification de la livraison des messages
Vérifier l'état de livraison dans Planfix
Cliquez sur l'icône en forme de coche à côté d'un message envoyé pour afficher le rapport de livraison pour tous les destinataires de ce commentaire.

Vérifier dans le rapport de livraison
Le rapport de livraison doit indiquer le client comme destinataire avec le statut Envoyé (sans statut d'erreur). Le rapport affiche la date, le canal (API Chat), le numéro de téléphone du destinataire et l'état de livraison.
meilleures pratiques
Configuration du modèle
- Utilisez des modèles de messages transactionnels pour l'initiation du chat (plus rentable que la promotion) - Gardez les messages de bienvenue concis et pertinents - Testez le modèle avec un petit groupe avant de le déployer
Gestion des tâches
- Utilisez des modèles de tâches distincts pour différents types de messages Viber Business
- Cochez la case de création automatique de tâches si vous traitez des demandes courtes et ponctuelles
- Gardez les tâches ouvertes pour les relations clients en cours afin de préserver l'historique des discussions
Automatisation
- Mettre en place des scénarios de réouverture des commentaires des employés et des clients
- Utiliser les dates d'achèvement prévues pour suivre le SLA
- Configurez soigneusement les destinataires des notifications pour éviter les messages involontaires
Dépannage
Les messages ne sont pas envoyés
- Vérifiez que les informations d'identification d'intégration sont correctes dans les paramètres Planfix
- Vérifiez que le numéro de téléphone du contact est au bon format
- Assurez-vous que le prospect est coché en tant que destinataire dans la liste de notification des commentaires
- Vérifiez que le modèle de message est approuvé
Les tâches ne sont pas créées automatiquement
- Confirmez que la case "Créer une nouvelle tâche s'il n'y a pas de tâches actives" est cochée
- Vérifiez que le modèle de tâche est correctement configuré
- Vérifiez que l'URL de notification est correctement définie
Le chat ne rouvre pas
- Vérifiez que les scénarios d'automatisation sont actifs
- Vérifiez que les conditions de statut correspondent aux statuts de votre flux de travail
- Assurez-vous que le champ « Démarrer le chat » est correctement configuré
Prochaines étapes
- API SMSBAT – En savoir plus sur l'envoi de messages via l'API - API Cascade – Configurer la diffusion de messages multicanaux
- Types de messages - Explorez les types de messages disponibles - Statut de livraison - Comprendre les statuts de livraison