Connecter d'autres programmes : API, webhooks et alertes Slack ou Teams

Dans Intégrations (sous Paramètres), vous pouvez connecter Kaam360 à d'autres programmes. Cela fait partie de la formule Entreprise. Seuls les administrateurs peuvent l'ouvrir.

Lire vos données avec une clé d'API

1. Ouvrez Paramètres et choisissez Intégrations.
2. Sous Clés d'API, saisissez un Nom (par exemple Zapier ou Tableur comptable) et appuyez sur Créer une clé d'API.
3. Copiez la clé qui apparaît. Elle ne s'affiche qu'une fois. Toute personne disposant de la clé peut lire toutes les données de votre organisation : gardez-la donc confidentielle.
4. Donnez la clé au programme. Il l'envoie dans l'en-tête Authorization: Bearer .... La page Utiliser l'API indique les adresses et donne un exemple.
5. Une clé ne peut que lire, sauf si vous cochez Autoriser cette clé à ajouter des prospects lors de sa création. Elle peut alors aussi ajouter de nouveaux prospects (voir ci-dessous). Elle ne peut jamais rien modifier ni supprimer d'autre. Appuyez sur Révoquer pour arrêter une clé immédiatement. Une clé cesse aussi de fonctionner lorsque la personne qui l'a créée est désactivée sous Utilisateurs ; créez-en une nouvelle depuis le compte d'un autre administrateur.

Utiliser Zapier ou Make

Zapier et Make sont des services qui relient des programmes entre eux sans aucun code. Vous n'avez pas besoin d'une application Kaam360 particulière pour les utiliser.

1. Créez une clé d'API comme ci-dessus. Cochez Autoriser cette clé à ajouter des prospects si vous voulez que des formulaires, des publicités ou des tableurs envoient des prospects dans Kaam360.
2. Dans Zapier ou Make, choisissez une étape qui appelle une adresse web (dans Zapier : Webhooks by Zapier ; dans Make : HTTP). Utilisez l'en-tête Authorization: Bearer ... avec votre clé.
3. Pour lire des données, appelez les adresses listées sous Utiliser l'API (par exemple /api/v1/leads ou /api/v1/deals). Pour ajouter un prospect, envoyez un POST à /api/v1/leads avec le nom ou l'e-mail du prospect.
4. La page Utiliser l'API renvoie aussi vers /api/v1/openapi.json, la description complète de l'API. Les développeurs et les outils peuvent la lire. Le guide complet du développeur, avec la nouvelle API (version 2), se trouve sur /developers.
5. Pour être prévenu lorsque quelque chose se produit, utilisez Un autre programme (JSON signé) sous les webhooks.

Recevoir des alertes dans Slack ou Microsoft Teams

1. Dans Slack ou Teams, créez un webhook entrant pour le canal voulu et copiez son adresse web.
2. Dans Intégrations, sous Webhooks et alertes de messagerie, saisissez un Nom, choisissez Un canal Slack ou Un canal Microsoft Teams, et collez l'Adresse web.
3. Sous Dites-lui quand, cochez ce dont vous voulez être informé. Ne cochez rien pour être informé de tout.
4. Appuyez sur Ajouter une adresse, puis sur Envoyer un test. Un court message de test doit apparaître dans le canal.

Prévenir un autre programme

1. Choisissez Un autre programme (JSON signé) et saisissez son adresse web. Elle doit commencer par https:// et être accessible sur l'internet public.
2. Copiez le secret de signature qui apparaît. Il ne s'affiche qu'une fois. L'autre programme l'utilise pour vérifier qu'un message provient bien de Kaam360.
3. Chaque message est un JSON avec un identifiant, le nom de l'événement, un court résumé et les principales informations. Utilisez l'API pour récupérer l'enregistrement complet.
4. Chaque message est signé : l'en-tête X-Kaam360-Signature contient un HMAC-SHA256 de l'heure d'envoi (X-Kaam360-Timestamp) et du message. Le destinataire doit refuser un message de plus de cinq minutes, pour qu'un message copié ne puisse pas être renvoyé plus tard. Le guide du développeur contient du code tout prêt pour cette vérification.
5. Pour modifier une adresse, ses événements ou sa note, appuyez sur Modifier. Si le secret a pu fuiter, appuyez sur Nouveau secret de signature : l'ancien cesse aussitôt de fonctionner, donnez donc immédiatement le nouveau à l'autre programme.

Ce dont vous pouvez être informé

Un client ou un prospect a été ajouté, une affaire a été gagnée ou perdue, un projet a été créé ou modifié, une tâche a été ajoutée, modifiée ou terminée, une facture a été rédigée, émise (envoyée), payée ou annulée, un paiement de projet est passé à une autre étape, un contrat a été signé, et un ticket de support a été ouvert.

L'historique des envois

L'Historique des envois liste chaque message des deux dernières semaines : quand il a été envoyé, à quelle adresse, la réponse du destinataire (son code de statut et son temps de réponse) et le résultat.

1. Choisissez une adresse, un résultat (Livré, En attente d'une nouvelle tentative, A abandonné) ou un événement pour n'afficher que ceux-ci.
2. Appuyez sur Afficher ce qui a été envoyé pour voir le message et le début de la réponse du destinataire.
3. Appuyez sur Renvoyer pour envoyer une fois de plus un message livré ou abandonné. Il garde le même identifiant, pour que le destinataire sache qu'il s'agit d'une répétition.

En cas de problème

• Si le destinataire est indisponible, Kaam360 réessaie après 1 minute, 5 minutes, 30 minutes, 2 heures et 12 heures, puis abandonne.
• Une adresse qui échoue 15 fois de suite est désactivée, et toutes les personnes qui peuvent gérer les intégrations reçoivent un e-mail. Une note rouge sur la page indique quand cela s'est produit. Corrigez le problème, appuyez sur Reprendre, puis renvoyez les messages manqués depuis l'Historique des envois.
• Les adresses d'un réseau privé (comme localhost, 10.0.0.1 ou 192.168.1.5) ne sont pas autorisées, et sont vérifiées de nouveau à chaque envoi de message.
• Si vous ne voyez pas Intégrations, votre formule ne l'inclut peut-être pas, ou votre rôle n'a peut-être pas le droit Gérer les intégrations.