Aller au contenu
KelkiDéveloppeurs

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

Trois cas d'usage

Le parcours

  1. Le besoin. POST /trade-matches avec le besoin en mots courants : proposez les 2 ou 3 premiers métiers à la personne.
  2. Les choix. GET /trades/{trade_id} : prestations et délais (listes fermées), texte d'accord en vigueur.
  3. Le lieu. GET /places?q=Créteil : un lieu existant, par exemple fr-creteil-94000.
  4. Le brouillon. POST /requests : rien n'est transmis ; vous recevez le récapitulatif et le texte d'accord.
  5. L'accord. Vous montrez le récapitulatif puis le texte d'accord mot pour mot, case non cochée ; la personne coche.
  6. La confirmation. POST /requests/{request_id}/confirmation (méthode email) : Kelki écrit à la personne ; son clic transmet la demande.
  7. 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.