# 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. En une phrase. Vous trouvez le métier (`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](https://kelki.ai/developers/fr/quickstart/) : six appels, du métier au webhook, en bac à sable. - [Concepts](https://kelki.ai/developers/fr/concepts/) : cycle de vie d'une demande, brouillon et accord, un seul professionnel. - [Consentement de la personne](https://kelki.ai/developers/fr/consent/) : page à lire avant toute intégration. - [Authentification](https://kelki.ai/developers/fr/authentication/), [référence de l'API](https://kelki.ai/developers/fr/reference/), [erreurs](https://kelki.ai/developers/fr/errors/). ## 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](https://kelki.ai/developers/fr/guides/conciergerie/)). - 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](https://kelki.ai/developers/fr/guides/agent/)). ## Le parcours - Le besoin. `POST /trade-matches` avec 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 exemple `fr-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éthode `email`) : 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](https://kelki.ai/developers/fr/terms/), l'[accord de traitement des données](https://kelki.ai/developers/fr/terms/data-processing/) (article 28 du RGPD) et la [politique d'usage acceptable](https://kelki.ai/developers/fr/terms/acceptable-use/). ## Sur cette page - URL : https://kelki.ai/developers/fr/ - Langue : fr - fr : https://kelki.ai/developers/fr/ - en : https://kelki.ai/developers/en/ - x-default : https://kelki.ai/developers/ - Portail : https://kelki.ai/developers/llms.txt