Aller au contenu

Slack

Votre équipe est prévenue dans son canal quand un client ouvre, approuve ou paie, sans ouvrir Cord.

Fonctionnement

Cord publie dans Slack au moyen d’un Incoming Webhook : une adresse que Slack génère pour un canal précis. Avec Ajouter à Slack, vous choisissez le canal dans Slack et Cord reçoit cette adresse automatiquement. Les alertes et les messages des workflows sont publiés uniquement dans ce canal.

Lors de l’autorisation, Slack vous montre les autorisations demandées par l’app Cord : publier dans le canal choisi, voir et compléter les liens Cord collés dans votre espace de travail (pour l’aperçu), recevoir la commande /cord et lire le nom et l’adresse e-mail de la personne qui clique sur un bouton de validation. Aucune ne permet à Cord de lire vos messages.

Il existe deux façons de recevoir des messages, et vous pouvez utiliser les deux :

Alertes de Notifications Action de workflow
Ce qui est publié Un message standard par événement de devis. Le texte que vous rédigez, avec les données de l’événement.
Quand Pour les événements que vous cochez dans Paramètres › Notifications. Avec l’un des 48 déclencheurs d’événements ou avec le déclencheur planifié, avec des conditions et des délais d’attente.
Où le configurer Paramètres › Notifications Workflows

Prérequis

Où Ce qu’il vous faut
Cord Le droit Paramètres. Toutes les offres.
Slack Pouvoir installer des apps dans votre espace de travail. Si votre espace restreint les installations, un administrateur Slack devra approuver l’app Cord.
Boutons de validation Les validations internes, qui relèvent de l’offre Scale ou supérieure ; la personne qui clique sur le bouton doit utiliser dans Slack la même adresse e-mail que dans Cord et disposer du droit Validations.

1. Connectez votre canal

  1. Allez dans Paramètres › Intégrations et touchez Slack.
  2. Cliquez sur Ajouter à Slack. Slack s’ouvre : choisissez le canal où vous voulez recevoir les alertes et cliquez sur Autoriser.
  3. À votre retour, la carte indique Connecté à #votre-canal. Cliquez sur Envoyer un test : un message concernant un devis de test « DEVIS-TEST » doit apparaître dans le canal.

Slack ajoute à votre espace de travail une app nommée Cord ; c’est elle qui signe les messages. Si votre espace restreint l’installation d’apps, un administrateur Slack devra l’approuver.

Alternative : votre propre webhook

Si vous préférez que les messages s’affichent avec le nom et l’icône de votre propre app Slack, ouvrez Utiliser votre propre webhook sur la même carte :

  1. Sur api.slack.com/apps, créez une app de zéro, ouvrez Incoming Webhooks, activez-les et cliquez sur Add New Webhook to Workspace pour choisir le canal.
  2. Copiez l’URL (elle commence par https://hooks.slack.com/services/), collez-la dans Cord et cliquez sur Enregistrer.
  3. Cliquez sur Envoyer un test. Le test utilise l’URL enregistrée, pas celle saisie dans le champ.

2. Activez les alertes

Connecter Slack n’active aucune alerte à lui seul. Allez dans Paramètres › Notifications et cochez la colonne Slack pour les événements souhaités :

Événement Quand l’alerte est envoyée
Votre client a consulté le devis Quand le client ouvre le lien public.
Devis approuvé Le client a accepté la proposition.
Devis refusé Le client l’a refusé.
Paiement reçu Le paiement en ligne a été enregistré.
Devis bientôt expiré 3 jours avant la date de validité.
Paiement en retard Une créance a dépassé son échéance.

Un membre a rejoint l’équipe n’est notifié que par e-mail ; il n’a pas d’option Slack.

Ce que contient chaque alerte

Chaque alerte de Notifications est un message court avec :

  • Le numéro du devis et ce qui s’est passé (consulté, approuvé, refusé, payé, bientôt expiré, paiement en retard).
  • Le client et le total avec sa devise.
  • Un lien Voir le devis qui ouvre le devis dans Cord.

Les alertes de Notifications concernent les devis : un événement sans numéro de devis n’est pas publié dans Slack.

Aperçus, commande /cord et validations

Cette fonctionnalité est nouvelle et n’est peut-être pas encore activée sur votre compte. Si vous ne la voyez pas, écrivez-nous.

Avec Ajouter à Slack, l’app Cord fait aussi ceci dans votre espace de travail :

  • Aperçu des liens. Un lien public de devis collé dans Slack s’affiche sous forme de carte avec le numéro, le client, le statut, le total et un bouton Ouvrir dans Cord. Cela ne fonctionne qu’avec les devis de votre propre organisation.
  • Commande /cord. Saisissez /cord suivi d’un numéro de devis ou du nom d’un client, par exemple /cord COT-0152. Vous seul voyez la réponse, qui affiche jusqu’à 5 devis.
  • Boutons de validation. Quand un devis demande une validation interne, il arrive dans le canal avec les boutons Valider, Refuser et Ouvrir dans Cord. Les boutons ne fonctionnent que si votre compte Slack utilise la même adresse e-mail que votre compte Cord et que vous disposez du droit Validations ; sinon, Slack vous invite à décider depuis Cord. Les validations internes nécessitent l’offre Scale ou supérieure.

Si vous avez connecté Slack avant l’arrivée de ces fonctions, la carte vous demande de vous reconnecter : cliquez sur Changer de canal et autorisez de nouveau. Elles ne sont pas disponibles avec votre propre webhook.

Messages personnalisés avec les workflows

Avec l’action Envoyer un message sur Slack de Cord Workflows, vous rédigez vous-même le message, avec les données de l’événement, et décidez quand il part. Exemples :

  • À la réception d’un acompte : « {{cliente}} a payé l’acompte de {{folio}} : {{monto}}. Solde : {{saldo_pendiente}}. »
  • À l’ouverture d’un litige : « Litige sur {{folio}} pour {{monto}}. Répondre avant le {{fecha_limite}}. »
  • À l’approbation d’une vente importante, uniquement si le total dépasse un certain montant.

Cette action publie dans le même canal et fonctionne même si les alertes de Notifications sont désactivées.

Ce qui circule et dans quel sens

Sens Ce qui circule Quand
De Cord vers Slack Les alertes que vous cochez dans Notifications : numéro du devis, ce qui s’est passé, client, total avec sa devise et le lien Voir le devis. Quand l’événement se produit.
De Cord vers Slack Le texte que vous rédigez dans l’action Envoyer un message sur Slack d’un workflow. Quand le workflow s’exécute.
De Cord vers Slack La carte d’aperçu d’un lien de devis de votre organisation, et la réponse de /cord, visible uniquement par la personne qui a saisi la commande. Quand quelqu’un colle le lien ou utilise la commande.
De Slack vers Cord La décision prise avec les boutons Valider ou Refuser d’une demande de validation interne. Quand une personne disposant du droit clique sur le bouton.
De Slack vers Cord Rien d’autre. Cord ne lit pas les messages de vos canaux. —

Limites

Limite Valeur
Canaux par organisation Un à la fois, celui choisi lors de la connexion
Messages depuis les workflows 120 par heure et par organisation
Longueur du message d’un workflow 1 000 caractères
Résultats de /cord Jusqu’à 5 devis
Aperçu des liens Uniquement les devis de votre propre organisation
Alertes de Notifications Uniquement les événements de devis avec un numéro

Changer de canal ou déconnecter

  • Changer de canal : cliquez sur Changer de canal sur la carte et choisissez-en un autre dans Slack. Avec votre propre webhook, créez-en un autre dans Slack et collez la nouvelle URL.
  • Déconnecter : cliquez sur Déconnecter sur la carte (avec votre propre webhook, effacez l’URL et enregistrez). Cord cesse de publier et le statut repasse à Non connecté. Les workflows comportant l’action Slack commenceront à échouer avec « Connectez Slack dans Paramètres › Intégrations pour utiliser cette action. »
  • Révoquer depuis Slack : si vous supprimez le webhook ou l’app dans Slack, l’URL cesse de fonctionner immédiatement, même si elle reste enregistrée dans Cord.

Cord ne peut publier que dans un seul canal à la fois. Pour recevoir des alertes dans plusieurs canaux, une option consiste à utiliser Make avec les webhooks de Cord.

Problèmes

Message Cause Que faire
L’URL Slack doit commencer par https://hooks.slack.com/ Vous avez collé une autre URL, par exemple celle du canal ou de l’app. Copiez l’URL de l’Incoming Webhook, celle qui commence par https://hooks.slack.com/.
Aucun webhook Slack n’est connecté. Collez l’URL et enregistrez d’abord. Vous avez cliqué sur Envoyer un test sans enregistrer. Cliquez sur Enregistrer, puis testez.
Slack n’a pas accepté le message. Vérifiez l’URL du webhook. Slack a refusé le message : le webhook a été supprimé, l’app a été retirée ou l’URL est incomplète. Créez un nouveau webhook et collez l’URL complète.
Impossible d’envoyer Erreur réseau pendant le test. Réessayez.
Le test arrive, mais pas les alertes Slack n’est pas coché pour ces événements. Vérifiez Paramètres › Notifications.

Traitez l’URL du webhook comme un mot de passe : toute personne qui la possède peut publier dans votre canal. Si vous pensez qu’elle a fuité, supprimez-la dans Slack et créez-en une nouvelle.

Voir aussi