Une API qui n’atteint que ce qu’on lui a donné.
Les organisations connectent un helpdesk, un CRM ou leur propre bot. Les personnes laissent une application agir pour elles, avec les permissions choisies. Chaque jeton atteint un ensemble fixe de routes, chaque webhook est signé, et rien de ce qu’une application fait n’est présenté comme venant d’une personne.
Fiche technique
- Applications
- Ajoutées sur la page de l’organisation. Chacune a son propre bot dans l’équipe, un jeton affiché une fois, et un webhook signé avec un secret affiché une fois. Remplacez l’un ou l’autre et l’ancien s’arrête immédiatement.
- Permissions
inbox:read,messages:read,messages:write,threads:write,updates,kits: accordées une à une. Une route que le jeton ne peut pas utiliser répond 403.- Webhooks
business.message,business.thread,kit.posted,kit.moved,ping. Signés, https seulement, aucune adresse privée, un seul délai pour tout l’échange.- Vos propres cartes
- Définissez un type de carte avec des champs et des états. Votre bot l’envoie, l’équipe et le client la font avancer, et chaque mouvement vous est signalé.
- Idempotent
- Chaque écriture porte un
clientId. La renvoyer rend le premier résultat, jamais un second message. - Débit
- 600 requêtes par minute et par jeton.
- Le sdk
@caime/sdk: un client typé pour chaque route qu’une application atteint, et la vérification des webhooks. À compiler depuis le dépôt en attendant sa publication sur npm.- Jetons personnels
- Une personne crée un jeton pour ses propres scripts (
profile:read,messages:read,messages:write,actions:read,actions:write). Il n’atteint jamais le compte lui-même. - OAuth
- Les applications tierces demandent le consentement des personnes (OAuth 2.0 ; erreurs selon les RFC 6749 et 7009), ne détiennent que ce qu’on leur a donné, et peuvent être révoquées à tout moment depuis les Réglages.
- Le guide
- Dans l’application : Réglages → Développeur, et à côté de chaque application sur la page de l’organisation.
Les règles de la marketplace
- Permissions
- Chacune est demandée parce que l’app s’en sert aujourd’hui, jamais pour une fonction à venir. Tout lire est examiné de plus près.
- Connecter
- Caime suit Connecter jusqu’au bout, comme le ferait une personne, avant de lister l’app.
- Aide et confidentialité
- Une adresse d’aide et une politique de confidentialité qui s’ouvrent, toutes deux sur la fiche. Si l’une cesse de fonctionner, l’app est retirée.
- Jamais
- Exporter ou sauvegarder les conversations en bloc, supprimer en masse, copier l’app de Caime, encaisser des paiements via Caime, entraîner un modèle sur ce qu’elle lit, ou un compte partagé entre plusieurs personnes.
- Un modèle
- Une app qui fait passer les mots des gens par un modèle dit lequel, ce qu’elle conserve, combien de temps et où. La fiche l’affiche comme Caime affiche ses propres sous-traitants.
- Âge
- Les applications agissent pour les plus de 18 ans.
- La fiche
- Une accroche, une catégorie, comment elle est payée, ses langues, jusqu’à 5 captures d’écran au format 8:5, où trouver de l’aide et sa politique de confidentialité.
- Changements
- Un changement de ce qu’affiche la fiche redemande une vérification. Une app laissée en panne est retirée, avec une note pour son développeur.
- L’ordre
- Selon le nombre de personnes qui l’ont connectée, puis les plus récentes. Pas de placement payant, pas de notes.
La marketplace Commencer gratuitement Pour les organisations