Présentation de l'API

L'API publique repose sur du JSON orienté ressources, via HTTPS, sous /api/v1. Elle est disponible avec les offres payantes et applique les mêmes droits d'accès aux sites, aux crédits et aux fonctionnalités que le tableau de bord.

Ce que vous pouvez automatiser#

• Les sites et leur état de publication
• La configuration des agents, les FAQ, les produits et les connaissances
• Les conversations (y compris les réponses du propriétaire, la mise en pause et la reprise), les leads, les statistiques, les notifications et les diffusions
• La création de leads et le recueil du consentement, les pipelines d'opportunités, les résultats CRM et la reprise après échec de synchronisation
• Les connecteurs, la monétisation, les tickets, l'équipe, l'utilisation et les informations du compte
• Les abonnements à des webhooks signés pour les événements pris en charge

Les actions sensibles passent par des points de terminaison d'action explicites, et non par une modification directe et sans restriction de la base de données. Les secrets des connecteurs sont acceptés en écriture, mais ne sont jamais renvoyés.

Il s'agit d'une API de gestion et de synchronisation. Elle permet de créer et de mettre à jour des leads, de les intégrer à un pipeline d'opportunités, d'importer des résultats CRM gagnés/perdus avec leur source d'attribution, de relancer les imports de résultats ayant échoué, et de répondre à un visiteur au nom de l'entreprise, en mettant l'agent en pause puis en le relançant sur cette conversation. L'envoi de messages en tant que visiteur reste une opération réservée au widget ; les statistiques et l'utilisation restent en lecture seule. Les domaines personnalisés ont été supprimés, et les routes /domains renvoient 409.

Démarrer en toute sécurité#

Créez une clé à portée limitée dans le tableau de bord, appelez le point de terminaison du compte courant, puis développez votre intégration sur un site de test avant de toucher au contenu de production.

curl https://makeagent.fast/api/v1/me \
  -H "Authorization: Bearer maf_live_YOUR_KEY"

Consultez Authentification, le démarrage rapide de l'API et la référence de l'API.