Ficiel MCP

Ajoute une note libre sur la fiche d'un contact. Portée « write » requise. Visible dans Ficiel comme une note manuelle.

Pose (ou retire) un tag EXISTANT de votre organisation sur un contact. Ne crée jamais de tag : utilisez les noms de ficiel_list_tags_and_stages, ou créez-le d'abord avec ficiel_create_tag. Les tags système se posent et se retirent ici aussi, avec les mêmes effets que dans l'app : « Blacklist » coupe tout message vers le contact et archive sa conversation, « Ignorer » le sort des relances. Portée « write » requise.

AFFICHE UN ÉCRAN : met en forme une analyse déjà calculée à partir des données Ficiel (titre, indicateurs clés, tableau, graphique, conclusion), au design de Ficiel, en clair ou en sombre. Pour une analyse sur mesure faite de plusieurs lectures : résultats par message d’ouverture, comparaison de comptes ou de séquences, résumé de compte. Aucune lecture, aucune écriture : l’écran affiche exactement les valeurs reçues et ne calcule rien.

ENVOIE le message d'une carte de relance à un vrai contact, au nom de l'organisation, par le chemin d'envoi unique de l'application (origine kord_card) : liste noire, étape protégée, tag bloquant, pause du canal, plafond des relances et espacement ; la carte doit être celle de la conversation visée. Un garde-fou qui refuse laisse la carte en attente et en donne la raison. recipient est obligatoire : le nom du contact tel que ficiel_list_pending_cards le donne, confronté au vrai contact avant tout envoi. edited_text (4000 caractères au plus) envoie un texte corrigé à la place de celui de Kord. Cartes texte seulement. Portée « write » requise.

Active des règles proposées par Kord (état de départ : proposed). Kord les suit ensuite dans ses relances ; ficiel_dismiss_learned_patterns les écarte à nouveau. Une règle qui n'est pas dans l'état de départ attendu n'est pas touchée ; le nombre de règles modifiées est rendu (updated). Portée « write » requise.

Sort la conversation de la boîte de réception ; elle revient d'elle-même au prochain message du contact, et ficiel_unarchive_conversation l'y remet. Conversation à deux ou groupe. Réversible, n'envoie aucun message et ne supprime rien. Si la conversation est déjà dans cet état, rien ne change et la réponse le dit (already_in_state). Portée « write » requise.

Pose ou retire la liste noire sur un contact. Portée « write » requise. Un contact en liste noire ne reçoit plus aucun message, ni manuel ni automatique, tant que la liste noire n'est pas retirée. Réversible : blacklisted=false la retire, rien n'est effacé ni annulé. Réutilise le même mécanisme que l'interface (tag système « Blacklist » + registre organisation), pas un raccourci parallèle.

Réserve dans l'agenda connecté le créneau qu'un contact a ACCEPTÉ, parmi ceux de ficiel_get_slots. Le créneau est revérifié libre juste avant, et refusé s'il est mis de côté pour un autre contact. GoHighLevel exige l'email ou le téléphone du contact ; Google Agenda n'exige rien (l'invitation part si l'email est connu) ; Calendly exige l'email et une offre Calendly payante (Standard minimum). Sans ces éléments, l'outil refuse en le disant. Succès : le rendez-vous est créé, les créneaux mis de côté pour ce contact sont libérés, la fiche passe en « RDV pris » avec sa date. N'envoie aucun message. Portée « write » requise.

Archive (archive=true) ou désarchive (archive=false) jusqu'à 50 contacts ET leurs conversations : ils quittent la boîte et la liste Contacts, comme l'archivage en lot de l'application. Réversible. EN DEUX TEMPS : sans confirm_token, SIMULATION (rien n'est écrit) avec les contacts concernés et les ignorés ; avec le jeton rendu et les mêmes paramètres, exécution. Un contact en liste noire n'est jamais touché. Portée « write » requise.

Déplace jusqu'à 50 contacts vers une étape du pipeline. EN DEUX TEMPS : un premier appel sans confirm_token est une SIMULATION (rien n'est écrit) qui liste les contacts qui changeraient, ceux ignorés et pourquoi (introuvable, supprimé, liste noire, déjà à cette étape), signale une étape protégée (plus d'envoi automatique), et rend un jeton ; le second appel, avec ce jeton et les mêmes paramètres, exécute. Chaque changement est journalisé. Portée « write » requise.

Pose (add) ou retire (remove) UN tag existant sur jusqu'à 50 contacts. EN DEUX TEMPS : sans confirm_token, SIMULATION (rien n'est écrit) avec les contacts concernés, les ignorés et pourquoi, et un avertissement si le tag exclut des relances ou bloque les envois automatiques ; avec le jeton rendu et les mêmes paramètres, exécution. Les tags système se posent et se retirent aussi en lot : « Blacklist » coupe tout message vers ces contacts, « Ignorer » les sort des relances ; retirer « Blacklist » vise des contacts en liste noire. Ne remplace jamais les autres tags d'un contact. Portée « write » requise.

Annule un message programmé encore en attente. Portée « write » requise. Exactement le bouton « Annuler » du composer : le message n'existe jamais pour le contact.

AFFICHE UN WIDGET : la relance préparée par Kord pour UNE conversation, avec le contexte (dernier échange, raison de relancer), un texte modifiable et les boutons Envoyer et Ne plus proposer. Si une relance attend déjà pour cette conversation, elle est reprise telle quelle ; sinon Kord prépare un brouillon, comme le lot de relances de Ficiel (compté dans le forfait mensuel de conversations). Avec text, ce texte est seulement affiché dans la carte à la place de celui de Kord : il n’est pas enregistré et le brouillon de Kord est conservé. Aucun message n’est envoyé et rien n’est supprimé : un brouillon périmé est marqué remplacé, jamais effacé. L’envoi demande le clic de l’utilisateur sur Envoyer.

Geste du bouton Changer d’étape de la fiche : passe le contact à une autre étape du pipeline.

AFFICHE UN ÉCRAN (chaque indicateur, avant et après). Compare la période en cours (period_days derniers jours) à la période équivalente immédiatement précédente, avec les deltas. La fenêtre ne remonte jamais avant l'inscription de l'organisation.

Lit ou modifie les heures calmes d'un canal entier (Instagram, WhatsApp…). Kord n'envoie jamais rien seul : la Délégation a été retirée le 24/10/2026. ATTENTION, les heures calmes NE BLOQUENT AUCUN ENVOI depuis le 08/09/2026 : plus aucune règle horaire ne refuse un message, quelle que soit son origine. Elles ne servent plus qu'à décaler l'heure à laquelle le lot de relances du matin est préparé (7 h 30 heure locale par défaut, sinon la fin de la plage calme). Portée « write » requise (y compris en lecture seule ; pour une lecture avec une clé read seule, voir les champs ai_master_enabled/quiet_start/quiet_end de ficiel_list_tags_and_stages). Le champ paused est conservé pour compatibilité : il n'a plus d'effet, Kord ne répond jamais seul.

Ajoute le texte de règles proposées ou adoptées aux instructions personnalisées de Kord (lisibles et modifiables par ficiel_edit_agent_prompt), puis les retire de la liste des règles apprises. Une règle qui n'est pas dans l'état de départ attendu n'est pas touchée ; le nombre de règles modifiées est rendu (updated). Portée « write » requise.

Crée la recette reengagement_48h (relance après silence) de votre organisation, si elle n'existe pas déjà. Portée « write » requise. comment_to_dm n'est pas créable ici (choix d'une publication surveillée dans un sélecteur) : configurez-la dans Ficiel, Automatisations, puis pilotez-la avec ficiel_set_automation.

Crée un tag dans votre organisation, avec les mêmes règles que l'interface : nom de 1 à 48 caractères, unique sans tenir compte de la casse (refus tag_exists si le nom existe déjà, y compris Blacklist et Ignorer), couleur facultative en hexadécimal à six chiffres (indigo #6366f1 par défaut). Le tag est placé en fin de liste, sans comportement particulier (ni exclusion des relances, ni blocage des envois automatiques : cela se règle dans l'interface). Il apparaît immédiatement dans l'application et dans ficiel_list_tags_and_stages. Pour le poser sur un contact, utilisez ensuite ficiel_add_tag. Portée « write » requise.

Met le contact d'une carte de relance de côté pendant jours (7, 14, 30 ou 90, 30 par défaut), comme « Reproposer plus tard » dans l'application : la carte sort du lot sans jugement et le contact revient en tête du lot du jour à la date de retour. Rien n'est envoyé ; le report s'annule dans l'application (Relances reportées). Cartes texte seulement. Portée « write » requise.

Écarte des règles proposées ou adoptées (états de départ : proposed, approved) : Kord ne les suit plus. Une règle qui n'est pas dans l'état de départ attendu n'est pas touchée ; le nombre de règles modifiées est rendu (updated). Portée « write » requise.

Modifie le profil STRUCTURÉ de Kord, comme l'écran de configuration, champ par champ : niche, positionnement, préréglage de ton (friendly, direct, warm, professional), tutoiement ou vouvoiement, emojis, langue de réponse, critères « qualifié » et « non qualifié », trame (étapes ordonnées), questions du script, action de fin (booking = rendez-vous, link = lien, handoff = passage à un humain), portrait de la cible, objections, canal de conversion, origine des conversations et ce que la personne a reçu avant d'écrire, problèmes déclarés, sources texte, retrait d'une source (lien ou texte), lien de réservation. Seuls les champs fournis changent ; une liste fournie REMPLACE la liste entière. Un texte trop long est REFUSÉ, jamais coupé. Le prompt de Kord est recompilé aussitôt. Chaque modification crée une version : ficiel_list_agent_config_versions la montre en entier, ficiel_restore_agent_config_version la restaure. Les instructions libres ne sont pas touchées (ficiel_edit_agent_prompt). Portée « write » requise.

Applique une ou plusieurs opérations de recherche/remplacement (ou d'ajout) sur les instructions personnalisées de votre organisation (custom_instructions). Portée « write » requise. N'écrase JAMAIS le texte en entier : chaque opération avec "search" doit trouver EXACTEMENT une occurrence, sinon l'appel est refusé (introuvable ou ambigu) plutôt que de deviner. Sans "search", le texte de l'opération est simplement ajouté à la fin. Certains réglages (ex. tutoiement/vouvoiement) vivent dans le profil structuré, pas dans ce texte : si aucune occurrence n'est trouvée, le réglage se change probablement dans Ficiel, Agent, Configuration.

Geste du bouton Envoyer de la carte de relance : envoie le texte (modifié ou non) au contact de la carte, par le même chemin que la validation d’une carte dans Ficiel (destinataire vérifié, liste noire, « Ne pas contacter », court délai naturel). Rend l’identifiant du message ; l’issue réelle se lit avec ficiel_statut_envoi.

AFFICHE UN WIDGET : la fiche d’une personne (canaux, premier échange, étape, tags, où vous en êtes, ce qu’elle cherche, objections relevées, prochaine action, derniers messages des deux côtés), avec les boutons Préparer une relance, Changer d’étape et Voir dans Ficiel. Identifie la personne par conversation_id, lead_id, ou contact (pseudo, nom ou numéro) ; si plusieurs personnes correspondent, la réponse liste les lead_id pour choisir.

Données sans écran. Contacts qui ont déjà répondu au moins une fois, à qui vous avez écrit en dernier, et qui n'ont plus donné signe depuis plus de silence_days jours. Même règle que la sélection « à relancer » de Ficiel : hors liste noire, hors groupes, hors étapes écartées de la relance, hors contacts exclus ou en pause. Un canal déconnecté reste listé en lecture seule (canal_deconnecte = true) : ses conversations se lisent, l'envoi attend la reconnexion. Triés du dernier signal du contact le plus récent au plus ancien.

Lit TOUTE la configuration de l'agent, chaque texte en entier : niche, positionnement, ton, emojis, langue, critères de qualification, questions du script, action de fin, cible, objections, conversion, origine des conversations, sources (et ce que Kord a retenu de chaque page), lien de réservation, modèle, le texte complet des instructions personnalisées (la zone libre, cible de ficiel_edit_agent_prompt) et le prompt compilé depuis le profil (lecture seule : il se modifie par ficiel_edit_agent_profile).

AFFICHE UN ÉCRAN (envois et réponses de la recette). Quand une recette a envoyé, à combien de contacts, avec quel taux de réponse, sur une fenêtre de jours. TOUTES les personnes touchées sont listées, de la plus récente à la plus ancienne, par pages (next_cursor).

Liste les recettes d'automatisation de votre organisation (commentaire vers message privé, relance après silence) : activation, contenu, état. Les messages sont écrits mot pour mot à l'avance par un humain, jamais générés à l'envoi.

Qui est en liste noire, et depuis quand quand c'est connu. Inclut les contacts blacklistés qui n'ont pas (encore) de conversation Ficiel. Paginé (next_cursor), total exact dans total.

AFFICHE UN ÉCRAN (cash signé et dormant). Les chiffres de la section Cash, deux nombres qui ne se mélangent jamais. CASH SIGNÉ : contacts aux étapes « client », avec le montant réellement encaissé saisi à la main (null = à renseigner, jamais 0) et la date de signature (null = inconnue) ; le total ne somme que les montants renseignés. CASH DORMANT estimé : contacts qui ont déjà écrit et se taisent depuis plus de 30 jours (définition LARGE, différente de ficiel_find_dormant_leads), × 5 % de reprise × panier moyen ; sans panier, aucun euro (estimate_cents null). Plus le montant de l'offre (panier), un changement programmé et l'historique. Montants en centimes. Réservé au propriétaire de l'organisation, comme dans l'application ; refusé pendant l'audit gratuit et pour une organisation suspendue. Lecture seule.

Pour chaque compte connecté (Instagram, WhatsApp, LinkedIn…) : état (connected, disconnected, connecting), dernière activité, date du dernier message reçu, et pour un compte coupé la date de la coupure, où en est la récupération de l'historique, avec la phrase exacte de l'écran Connexions (prochaine reprise, fin estimée « d'ici »), une éventuelle récupération en cours, les dernières récupérations (5 par défaut, jusqu'à 100 avec passes ; conversations et messages ramenés, tronquée ou non, incident oui ou non) et si le bouton « Récupérer l'historique » est disponible. Lecture seule : aucun import n'est déclenché d'ici. Filtrable par canal ou par compte (account_id de ficiel_list_tags_and_stages).

Une conversation complète : fiche du contact et messages, du plus récent au plus ancien, 50 par page (next_cursor pour remonter dans le passé). Les vocaux apparaissent avec leur transcription COMPLÈTE (aucune coupure, tous les caractères) dans voice_transcription et dans la ligne de texte. Quand elle manque, transcription_status vaut en_attente ou indisponible et transcription_reason dit pourquoi (audio purgé chez le fournisseur, échec, en cours). Fonctionne aussi sur une conversation de groupe : chaque message porte alors son auteur (author) et la fiche liste les participants.

AFFICHE UN ÉCRAN (l'entonnoir de l'écran Statistiques, mêmes chiffres). Six étapes sur une période, tous canaux ou un seul : nouveaux contacts → en qualification → qualifiés (critères écrits pour Kord) → lien envoyé → réservés → signés, avec la part de l'étape d'avant, plus le taux de réponse et le taux de booking.

AFFICHE UN ÉCRAN (la fiche du prospect). Fiche complète d'un contact : identité affichée, canaux où une conversation existe (avec l'état de lecture de notre dernier message), étape, tags, résumé et notes EN ENTIER, compteurs de messages entrants/sortants et dernier contact. Les notes vont de la plus récente à la plus ancienne, 20 par page : notes_next_cursor (dans notes_cursor) donne les suivantes, notes_total dit combien il y en a.

AFFICHE UN ÉCRAN (le ou les contacts trouvés, avec leur fiche). Retrouve un ou plusieurs contacts à partir d'un identifiant de canal (@pseudo Instagram, numéro WhatsApp, identifiant LinkedIn) OU de son nom affiché (prénom, nom, nom de profil ; recherche partielle, insensible à la casse et aux accents, tous canaux si channel est omis), ou une conversation de groupe par son nom (résultat marqué is_group, avec son conversation_id). Chaque résultat porte un link ouvrable dans un navigateur (URL par identifiant, ouvre toujours) et un link_readable lisible (/inbox/@pseudo@canal) quand la fiche le permet. Meilleur effort : un nom absent des fiches peut figurer dans le contenu des messages.

AFFICHE UN ÉCRAN (la fiche du prospect). Contexte chronologique d'un contact, tous canaux confondus : fiche, puis ses messages du plus ancien au plus récent, une ligne par message, chaque message EN ENTIER (les vocaux avec leur transcription complète ou la raison de son absence). Par pages de 500 messages au plus, les plus récents d'abord : next_cursor (dans cursor) remonte vers l'historique plus ancien, rien n'est perdu. Donne aussi, par canal, si notre dernier message a été vu. Pensé pour être lu d'un bloc par un assistant avant de décider quoi faire.

Rend l'ORIGINAL d'un média d'une conversation, pour le voir vous-même : une image est renvoyée comme image (redimensionnée à 1 568 px au plus), un document comme fichier intégré (10 Mo au plus). Une vidéo n'est pas transmise : sa durée, ses paroles et sa description suffisent. La réponse donne aussi le texte déjà tiré du média (description, texte visible, texte du document), en entier. message_id vient de ficiel_get_conversation, ficiel_get_lead_context ou ficiel_search (champ media d'un message). Lecture seule.

Ce qu'il reste à envoyer sur chaque canal connecté avant le plafond horaire ou journalier, et si le canal est actuellement en pause (coupe-circuit).

Lit les créneaux RÉELLEMENT libres de l'agenda connecté à Ficiel (GoHighLevel ou Google Agenda, page Intégrations), sur les 30 prochains jours et au moins 2 h après maintenant : 6 par défaut, répartis sur plusieurs jours (un par jour en partant du plus proche). Les disponibilités du prospect filtrent la liste : jours de la semaine, plage horaire (après, avant), date de début, nombre de jours. Avec lead_id, les créneaux rendus sont mis de côté 24 h pour ce contact : ils ne sont proposés à aucun autre contact pendant ce temps, et le même contact retrouve sa liste. Sans lead_id, rien n'est mis de côté. Sans agenda connecté, l'outil le dit et rend le lien de réservation s'il existe.

AFFICHE UN ÉCRAN (tuiles et courbe). Les agrégats de la page Statistiques de Ficiel sur une période : conversations actives, avec message envoyé, avec réponse, qualifiées, en attente d'appel, rendez-vous pris, messages reçus et envoyés, suggestions utilisées, plus la série temporelle et les taux de réponse et de rendez-vous calculés comme dans l'interface. Qualifiées / en attente d'appel / rendez-vous pris comptent les contacts passés à l'étape SUR la période. La fenêtre ne remonte jamais avant l'inscription de l'organisation (activity_since) : l'historique importé plus ancien n'est pas de l'activité.

AFFICHE UN ÉCRAN (un bloc par compte, avec son logo). Les mêmes agrégats que ficiel_get_stats, découpés par canal connecté, sur une période.

AFFICHE UN WIDGET : la liste des contacts à relancer, une carte par contact (nom, canal, dernier message, depuis quand, étape, et s’il a VU ton dernier message), avec les boutons Relancer, Voir la conversation et Ne plus proposer. Avec vus_seulement=true, seulement les contacts qui ont vu le dernier message. Même sélection que les relances de Ficiel : seulement des contacts qui ont déjà répondu au moins une fois, hors liste noire, hors « Ne pas contacter », hors étapes écartées et contacts exclus. Un canal déconnecté reste dans la liste en lecture seule (canal_deconnecte = true) : on peut lire ses conversations, pas lui préparer ni lui envoyer de relance avant la reconnexion. Le bouton Relancer ouvre la carte de relance dans le widget.

Liste les versions de la configuration de Kord, de la plus récente à la plus ancienne (chaque version est l'état d'AVANT une modification), chacune avec son texte COMPLET : version_id, date, taille, instructions entières. Paginé (limit, 10 par défaut, 30 au plus ; cursor = next_cursor de la page précédente) : un texte n'est jamais coupé. Avec version_id, renvoie cette seule version. Lecture seule. Sert à retrouver un état antérieur avant ficiel_restore_agent_config_version.

Liste paginée des conversations de votre organisation, du dernier message le plus récent au plus ancien, échanges à deux ET groupes. Filtres : canal, étape du pipeline, tags (noms exacts, voir ficiel_list_tags_and_stages), période du dernier message, non lues, vu sans réponse, kind (direct ou group). Chaque élément est un résumé (nom, canal, étape, tags, dernier message EN ENTIER) : le détail est dans la conversation complète. last_outbound_seen dit si notre dernier message a été vu (vu, non_vu, inconnu ; null si le dernier message vient du contact) : fiable sur WhatsApp, sur Instagram seulement quand la lecture est attribuée au contact, inconnu sur LinkedIn. « inconnu » ne veut jamais dire « pas lu » (confirmations de lecture coupées, ou canal muet). Chaque élément porte un link ouvrable dans un navigateur (URL par identifiant, ouvre toujours la conversation) et un link_readable lisible (/inbox/@pseudo@canal) quand la fiche le permet. Un groupe porte kind=group et la liste de ses participants (déduite des messages) ; un échange à deux porte kind=direct.

Liste les fusions ENCORE ACTIVES dont ce contact est la fiche principale (« Fiches réunies ici » dans l'application) : merge_id, fiche réunie, date, auteur, nombre de conversations déplacées. Le merge_id sert à ficiel_unmerge_leads. legacy=true signale une ancienne fusion dont les tags et notes ne pourront pas être rendus. Lecture seule.

Liste les règles apprises par Kord (style, objections, ouvertures) avec leur état de validation. "proposed" = en attente de votre décision (voir ficiel_approve_learned_patterns, ficiel_dismiss_learned_patterns, ficiel_convert_learned_patterns), "approved" = adoptée, "dismissed" = écartée, "auto" = règle obligatoire de la plateforme (jamais proposée à la modification).

AFFICHE UN ÉCRAN (une carte par relance prête, à ouvrir). Liste les cartes de Kord qui attendent une décision : le lot de relances du matin (kind=relance_du_lot, palier d'ancienneté, date du lot) et les suggestions en attente. Chaque carte donne card_id, contact, canal, conversation_id, TEXTE EXACT qui serait envoyé, raison de Kord et âge en jours. Seules les cartes texte sont listées ; une carte vocale se valide dans l'application. Lecture seule : rien n'est envoyé.

AFFICHE UN ÉCRAN (la liste des messages programmés). Liste les messages programmés (« Prévoir ce message ») de votre organisation, ou d'une seule conversation, texte EN ENTIER. Par défaut, seulement ceux encore en attente. Paginé (next_cursor), total exact.

Les noms exacts à utiliser dans les autres outils : tags de l'organisation, étapes du pipeline (stage_key et libellé), canaux connectés (avec les horaires calmes de chacun).

Les membres de votre organisation, comme l'écran Réglages › Équipe : adresse email, Admin ou Agent, propriétaire ou non, s'il s'est déjà connecté, état de son invitation, ses permissions (Assistant, Envoyer des messages, Automatisations, Exporter, Tags et étapes, Statistiques), les tags qui lui sont masqués et les canaux qu'il voit. Un Admin a toutes les permissions. Lecture seule : inviter, modifier ou retirer un membre se fait dans Ficiel.

Liste les modèles de messages (réponses types) de votre organisation, dans l'ordre de l'interface : épinglés, puis les plus utilisés. Chaque modèle donne template_id, titre, texte complet (avec ses variables {prénom}, {ig_handle}, {date}, {stage_pipeline}), catégorie et nombre d'utilisations. Filtrable par mot (titre ou texte) et par catégorie. Lecture seule.

Liste la bibliothèque de vocaux préenregistrés de votre organisation (Ficiel, Voix) : clip_id, nom, ce qui est dit (transcript) et durée. Ce sont des enregistrements de votre voix, envoyés tels quels. Le clip_id sert à envoyer un vocal (ficiel_send_media, kind=voice) ou à le désigner dans une étape d'automatisation (voice_clip_id). Lecture seule : cet outil n'envoie rien.

Enregistre qu'un rendez-vous a été pris avec un contact (par exemple dans votre agenda ou votre CRM, hors de Ficiel) : la date et l'heure RÉELLES du rendez-vous sont posées sur la fiche, et le contact passe à « RDV pris » s'il était avant cette étape (un contact déjà en no-show, signé ou perdu garde son étape, seule la date est mise à jour). Le passage est journalisé et compte dans le flux. N'envoie aucun message : confirmez l'heure au contact avec ficiel_send_message. Portée « write » requise.

Marque la conversation comme lue, comme l'ouverture dans l'interface. Conversation à deux ou groupe. Réversible, n'envoie aucun message et ne supprime rien. Si la conversation est déjà dans cet état, rien ne change et la réponse le dit (already_in_state). Portée « write » requise.

Remet la conversation en non lue, comme dans l'interface. Conversation à deux ou groupe. Réversible, n'envoie aucun message et ne supprime rien. Si la conversation est déjà dans cet état, rien ne change et la réponse le dit (already_in_state). Portée « write » requise.

Fusionne le contact satellite_lead_id DANS le contact principal master_lead_id (deux fiches de la même personne), avec la fonction de l'application : conversations re-pointées sur la principale (en cas de collision de canal, l'une est archivée, aucun message n'est supprimé), tags, notes et événements réunis, fiche principale complétée sans rien écraser, la fiche satellite quitte les listes. Réversible avec ficiel_unmerge_leads tant que rien n'est purgé : le merge_id renvoyé sert à défaire. Les chaînes de fusion sont interdites. Une fusion à tort mélange deux historiques de conversation. confirm doit valoir true, c'est la confirmation explicite. N'envoie aucun message. Portée « write » requise.

Geste du bouton Ne plus proposer : le contact sort des relances, comme le refus d’une carte du lot dans Ficiel (tag « Ignorer », levé s’il répond ou si le tag est retiré). Les relances en attente pour cette conversation sont refusées.

Coupe (ou réactive) ce que Kord prépare de lui-même sur CE contact précis : le lot quotidien de relances. N'affecte jamais le bouton « Suggérer » ni votre capacité à écrire à la main. Portée « write » requise. Exactement le même réglage que le bouton pause de la conversation dans Ficiel.

Épingle la conversation en haut de la boîte de réception. Conversation à deux ou groupe. Réversible, n'envoie aucun message et ne supprime rien. Si la conversation est déjà dans cet état, rien ne change et la réponse le dit (already_in_state). Portée « write » requise.

AFFICHE UN ÉCRAN (la carte de relance, modifiable, avec le bouton Envoyer). Fait rédiger par Kord UNE relance pour une conversation, exactement comme le bouton « Préparer » de la liste « À relancer » : verdict de qualification, puis rédaction, puis carte en attente. N'ENVOIE RIEN : la carte s'approuve ensuite avec ficiel_approve_card (ou dans Ficiel). recipient est OBLIGATOIRE, confronté au vrai contact avant toute génération. Refusé avant tout appel à l'IA si le contact n'est pas relançable (liste noire, tag ou étape exclus des relances, Kord coupé, au repos, déjà contacté aujourd'hui, automatisation en cours, canal déconnecté, groupe). Une carte déjà en attente est rendue telle quelle, sans nouvelle rédaction. Coûte une conversation du quota mensuel. Portée « write » requise.

Écarte une carte de relance sans rien envoyer ; le rejet nourrit l'apprentissage de Kord. Pour une carte du lot quotidien, le contact est aussi retiré des relances (tag « Ignorer », comme dans l'application, retirable depuis la fiche du contact) : confirm_exclusion=true est alors exigé. Cartes texte seulement. Portée « write » requise.

Renvoie le texte d'un modèle avec les variables remplies pour un contact ({prénom}, {ig_handle}, {date}, {stage_pipeline}), comme l'interface au moment de l'insertion. Les variables sans valeur pour ce contact restent telles quelles et sont listées dans unresolved_variables (à relire avant tout envoi). N'envoie rien : le texte obtenu s'envoie ensuite avec ficiel_send_message (destinataire nommé obligatoire). Lecture seule.

Remet la configuration de Kord (instructions personnalisées, prompt, profil) dans l'état d'une version de ficiel_list_agent_config_versions. Effet immédiat sur les réponses de Kord. Réversible : la restauration enregistre elle-même l'état qu'elle remplace comme nouvelle version, que l'on peut restaurer à son tour. Permet d'annuler une édition des instructions. Portée « write » requise.

Crée une étape du pipeline si stage_key n'existe pas (label requis ; clé 2 à 40 caractères en minuscules, chiffres et underscore, commençant par une lettre ; libellé 2 à 60 ; couleur hexadécimale, violet par défaut ; ajoutée en fin de liste), ou modifie l'étape existante (label, color, is_terminal, excludes_from_relance : seuls les champs fournis changent). La clé ne change jamais. excludes_from_relance retire de la relance les contacts de cette étape. Ne supprime ni ne réordonne aucune étape. Portée « write » requise.

Sans template_id : crée un modèle (title et body requis ; titre 1 à 140 caractères, texte 1 à 4000, catégorie 1 à 60 facultative), comme dans l'interface. Avec template_id : modifie ce modèle, seuls les champs fournis changent (category à null retire la catégorie). Le texte peut contenir {prénom}, {ig_handle}, {date}, {stage_pipeline}. Ne supprime jamais un modèle, n'en envoie aucun. Portée « write » requise.

Programme l'envoi d'un message texte dans une conversation existante, à une date et une heure choisies. Portée « write » requise. Exactement le mécanisme du bouton « Prévoir ce message » du composer (même table, même réveil, même annulation automatique si le contact répond avant l'heure) : aucune différence entre un message programmé via MCP et un message programmé à la main. Un seul message programmé à la fois par conversation (annulez l'existant avec ficiel_cancel_scheduled pour le remplacer). Le destinataire nommé (recipient) est vérifié TOUT DE SUITE, à la programmation : un message prévu part tout seul le moment venu, se tromper de cible ici ne se rattraperait pas. Les autres garde-fous d'un envoi immédiat s'appliquent à l'HEURE PRÉVUE, pas à la programmation : un refus (plafond du canal, tag bloquant) survient alors et annule le message, visible dans ficiel_list_scheduled.

Recherche en texte intégral dans tous les messages de votre organisation (texte et transcriptions de vocaux). Un vocal trouvé (et un vocal voisin) est rendu avec sa transcription COMPLÈTE : voice_transcription et excerpt, sans coupure ; message_kind vaut voice ou text. Syntaxe libre : plusieurs mots = tous requis, guillemets pour une expression, "-mot" pour exclure. Chaque résultat donne le message trouvé avec le message juste avant et juste après. Du plus récent au plus ancien, paginé.

Envoie un document à partir de son texte, dans une conversation existante (échange à deux, ou groupe via conversation_id). Portée « write » requise. Ficiel fabrique le fichier : format=pdf met en page un texte Markdown (titres, listes, tableaux, citations, code, liens) en PDF ; format=markdown, texte ou csv envoie le texte tel quel en fichier .md, .txt ou .csv (UTF-8). Le texte passe en clair dans contenu, jusqu'à 2 millions de caractères : aucun encodage base64. Le titre donne le nom du fichier, et l'en-tête du PDF si le texte ne commence pas par un titre de niveau 1. Les images du Markdown ne sont pas intégrées au PDF (leur texte alternatif est affiché). Mêmes garde-fous que ficiel_send_media (destinataire nommé vérifié, liste noire, étapes protégées, plafonds, pause de canal). Irréversible.

Envoie une image, une vidéo, un document ou un vocal enregistré dans une conversation existante (échange à deux, ou groupe via conversation_id). Portée « write » requise. Image/vidéo/document : deux façons de donner le fichier, une seule par appel. Un fichier que vous venez de produire ou que vous avez sous la main : media_base64 (son contenu entier en base64), avec mime_type et file_name, jusqu'à 10 Mo. Un fichier déjà en ligne : media_url, une adresse publique accessible sans authentification (max 10 Mo image, 100 Mo vidéo, 50 Mo document). Le type réel du fichier est vérifié sur son contenu : il doit correspondre au type annoncé. Un document dont le texte est connu (Markdown, texte, CSV) part aussi par ficiel_send_document, qui fabrique le fichier, PDF compris, sans base64. Vocal : un des vocaux préenregistrés de votre organisation (voice_clip_id), envoyé tel quel ; aucun vocal n'est généré. Mêmes garde-fous que ficiel_send_message (destinataire nommé vérifié, liste noire, étapes protégées, plafonds, pause de canal). Irréversible.

Envoie un message texte dans une conversation existante, depuis le compte de votre organisation : un échange à deux, ou une conversation de GROUPE. Portée « write » requise. Ciblez la conversation par conversation_id (recommandé, seul moyen pour un groupe), ou un contact par lead_id + channel, ET nommez le destinataire dans recipient : le serveur vérifie que la conversation lui appartient vraiment avant d'envoyer quoi que ce soit. Passe par les mêmes garde-fous que Ficiel, dans cet ordre : liste noire, étapes protégées (échanges à deux), tags bloquants, pause du canal, plafonds d'envoi par canal. Un garde-fou qui refuse = erreur immédiate avec la raison, jamais de mise en attente. La réponse « envoyé » n'est rendue que lorsque le canal a accepté le message et rendu un identifiant ; toute autre issue est une erreur explicite. Dans un groupe, le message est vu par tous les participants ; la réponse porte is_group=true et attend la confirmation du canal. Le message apparaît dans votre boîte de réception comme un envoi normal. Irréversible.

Active/désactive une recette existante, ou remplace le contenu des relances de reengagement_48h (steps). Portée « write » requise. Ne crée jamais de recette : elle doit déjà exister (configurée une première fois dans Ficiel, Automatisations). comment_to_dm ne se modifie que par enabled via cet outil : son contenu (publication surveillée, mot-clé) se règle dans l'interface.

Règle le montant de votre offre, en centimes (entier de 100 à 100 000 000), ou null pour l'effacer : c'est le panier qui sert à estimer le cash dormant. effective_date (AAAA-MM-JJ, facultative, au plus un an) fait partir le nouveau montant à minuit heure de Paris ce jour-là ; sans elle, il s'applique tout de suite. Chaque changement est historisé (ficiel_get_cash). Mêmes portes que ficiel_get_cash. Portée « write » requise.

Pose, corrige ou retire (null) le montant réellement encaissé avec un contact, en centimes (entier de 0 à 100 000 000, soit 1 000 000 €). C'est le chiffre qui alimente le cash signé. Ne change ni l'étape (ficiel_set_stage, qui date la signature au passage en client) ni rien d'autre. Rend l'ancien et le nouveau montant. Mêmes portes que ficiel_get_cash (drapeau Cash, organisation abonnée). Portée « write » requise.

Change l'étape (pipeline_stage) d'un contact. Portée « write » requise. Refuse si l'étape n'existe pas dans votre organisation (voir ficiel_list_tags_and_stages pour les stage_key exacts). Ne touche à rien d'autre : ni tags, ni conversations, ni envoi.

AUCUN MESSAGE N'EST ENVOYÉ. Simule ce que Kord répondrait sur une conversation, avec l'identité, le ton et les règles apprises de votre organisation, et rend le texte pour relecture uniquement. Approximation, pas une reproduction exacte du bouton « Suggérer » de l'interface (moteur partagé, réglages fins différents). Consomme le même quota mensuel de conversations traitées par l'IA que toute génération réelle.

L’issue réelle d’un message envoyé depuis le widget : envoye (le canal l’a accepté), non_envoye (avec la raison) ou en_cours.

AFFICHE UN WIDGET : l’écran Statistiques sur 30 ou 90 jours : messages reçus et envoyés, l’entonnoir (nouveaux contacts, en qualification, qualifiés, lien envoyé, réservés, signés), taux de réponse et taux de booking, comparés à la période précédente, avec la courbe des messages par jour. Mêmes chiffres que l’application, calculés à la même source.

Remet la conversation dans la boîte de réception. Une éventuelle conversation jumelle active du même contact sur le même compte est archivée à sa place. Conversation à deux ou groupe. Réversible, n'envoie aucun message et ne supprime rien. Si la conversation est déjà dans cet état, rien ne change et la réponse le dit (already_in_state). Portée « write » requise.

Défait une fusion (merge_id de ficiel_list_lead_merges) dont lead_id est la fiche principale : conversations et messages rendus à la fiche réunie, tags, notes et événements restitués, champs de la principale ramenés à leur valeur d'avant. tags_policy règle ce qui a été ajouté APRÈS la fusion : keep_master (défaut, reste sur la principale) ou copy_both (les tags posés depuis vont sur les deux fiches). Refusée avec la raison si une fiche a été purgée, rattachée ailleurs depuis, ou si une conversation active occupe déjà le canal. N'envoie aucun message. Portée « write » requise.

Retire l'épingle : la conversation revient au classement automatique. Conversation à deux ou groupe. Réversible, n'envoie aucun message et ne supprime rien. Si la conversation est déjà dans cet état, rien ne change et la réponse le dit (already_in_state). Portée « write » requise.

Modifie les champs de la fiche d'un contact, ceux du formulaire de l'application : prenom, nom, telephone, email, disponibilite (texte libre), score (entier 0 à 100) et custom_display_name (surnom affiché). Seuls les champs fournis changent ; null ou un texte vide EFFACE le champ. Renvoie ce qui a changé (avant, après). Attention : le surnom et le téléphone servent à reconnaître le contact dans les outils d'envoi (destinataire nommé). Ne touche ni l'étape (ficiel_set_stage), ni la note (ficiel_add_note), ni Kord, ni le montant encaissé, ni le verdict de qualification. Portée « write » requise.

Modifie un tag existant (tag_id de ficiel_list_tags_and_stages) : name (1 à 48 caractères, unique sans tenir compte de la casse), color (hexadécimal à six chiffres), description (500 caractères au plus, null pour l'effacer), excludes_from_relance et blocks_auto_send. Seuls les champs fournis changent. ⚠️ Les deux derniers CHANGENT DES ENVOIS : excludes_from_relance retire de la relance tous les contacts qui portent le tag, blocks_auto_send bloque les envois automatiques vers eux ; la réponse le rappelle. Un tag système (Blacklist, Ignorer) garde son nom et sa description : seules sa couleur et ses comportements se règlent. Ne supprime jamais un tag. Portée « write » requise.