Intégrer l'Agent Kelki à votre application
Un clic dans votre application, et la personne est rappelée par un professionnel du bon métier. L'API reprend exactement les règles du formulaire « Rappelez-moi » de kelki.ai et du connecteur MCP : mêmes listes, mêmes contrôles, même confirmation par la personne.
L'API est gratuite pour les partenaires.
POST /trade-matches), vous affichez ses prestations et ses délais (GET /trades/{trade_id}), vous vérifiez le lieu (GET /places), vous préparez un brouillon (POST /requests) que vous montrez à la personne avec le texte d'accord, puis vous lancez la confirmation (POST /requests/{request_id}/confirmation). La personne reçoit l'e-mail « Confirmer ma demande » : après son clic, la demande part vers les professionnels de son secteur. Ou bien l'Agent Kelki mène la conversation (/agent/conversations).Adresse de l'API : https://kelki.ai/api/v1. Ressources et champs en anglais, valeurs (métiers, prestations, délais, textes) dans la langue demandée.
Par où commencer
- Démarrage rapide : six appels, du métier au webhook, en bac à sable.
- Concepts : cycle de vie d'une demande, brouillon et accord, un seul professionnel.
- Consentement de la personne : page à lire avant toute intégration.
- Authentification, référence de l'API, erreurs.
Trois cas d'usage
- Conciergerie : une fuite, une serrure bloquée dans un logement de courte durée ; un bouton « Trouver un professionnel » dans l'application (guide).
- Gestion locative : le locataire signale un problème ; la demande part avec la référence du lot, le suivi remonte par webhook.
- Assistant : votre assistant conversationnel confie le besoin à l'Agent Kelki (guide).
Le parcours
- Le besoin.
POST /trade-matchesavec le besoin en mots courants : proposez les 2 ou 3 premiers métiers à la personne. - Les choix.
GET /trades/{trade_id}: prestations et délais (listes fermées), texte d'accord en vigueur. - Le lieu.
GET /places?q=Créteil: un lieu existant, par exemplefr-creteil-94000. - Le brouillon.
POST /requests: rien n'est transmis ; vous recevez le récapitulatif et le texte d'accord. - L'accord. Vous montrez le récapitulatif puis le texte d'accord mot pour mot, case non cochée ; la personne coche.
- La confirmation.
POST /requests/{request_id}/confirmation(méthodeemail) : Kelki écrit à la personne ; son clic transmet la demande. - Le suivi. Webhook
request.status_changed:transmitted,sold(prise par un seul professionnel),called_back.
Ce que vous ne recevez jamais
Ni les coordonnées d'un professionnel, ni son identité, ni les coordonnées de la personne en clair (elles reviennent masquées : C•••, +33 6 •• •• •• 42), ni la provenance des demandes. Kelki ne vend aucune donnée au partenaire.
Pays et langues
Les pays couverts, leurs langues et leur disponibilité se lisent avec GET /countries : live (demandes acceptées) ou preparing (référentiel consultable, demandes refusées avec country_not_available).
Conditions
L'utilisation de l'API est encadrée par les conditions d'utilisation de l'API, l'accord de traitement des données (article 28 du RGPD) et la politique d'usage acceptable.