Ficiel

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.

ficiel_get_cash

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

ficiel_changer_etape

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.

ficiel_bulk_set_stage

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.

ficiel_compare_periods

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.

ficiel_get_lead_context

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.

ficiel_convert_learned_patterns

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.

ficiel_save_template

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.

ficiel_save_stage

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.

ficiel_create_tag

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.

ficiel_create_automation

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.

ficiel_get_slots

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.

ficiel_unmerge_leads

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.

ficiel_set_stage

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.

ficiel_unarchive_conversation

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.

ficiel_unpin_conversation

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.

ficiel_get_funnel

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.

ficiel_send_document

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.

ficiel_send_message

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.

ficiel_send_media

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.

ficiel_envoyer_relance

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.

ficiel_get_lead

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.

ficiel_fiche_prospect

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.

ficiel_list_lead_merges

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.

ficiel_merge_leads

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).

ficiel_get_automation_runs

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.

ficiel_list_agent_config_versions

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.

ficiel_statut_envoi

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).

ficiel_get_agent_config

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.

ficiel_get_automations

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.

ficiel_get_conversation

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.

ficiel_get_blacklist

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.

ficiel_list_conversations

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.

ficiel_list_scheduled

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.

ficiel_list_templates

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).

ficiel_list_learned_patterns

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.

ficiel_mark_booked

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.

ficiel_mark_conversation_read

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.

ficiel_mark_conversation_unread

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.

ficiel_list_team_members

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.

ficiel_pause_conversation