Prévoir un message pour plus tard
ficiel_schedule_messageProgramme 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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Texte du message. | |
| channel | No | Canal : requis avec lead_id ; avec conversation_id, sert seulement de vérification. | |
| lead_id | No | Identifiant du contact (lead_id), avec channel. Inutile si conversation_id est donné. | |
| send_at | Yes | Date et heure d'envoi, ISO 8601 AVEC fuseau (ex. 2026-08-31T10:06:00+02:00). Entre 1 minute et 2 mois dans le futur. | |
| recipient | Yes | OBLIGATOIRE : le destinataire tel que vous le nommez — nom affiché, @pseudo Instagram ou LinkedIn, numéro pour WhatsApp, nom du groupe pour une conversation de groupe. Le serveur le compare au contact réel de la cible avant tout envoi (casse et accents ignorés ; le nom complet, le prénom seul ou le pseudo exact suffisent). Si Ficiel ne connaît AUCUNE identité pour ce contact (ni pseudo, ni nom, ni numéro), indiquez exactement « sans nom » : c'est la façon de dire que vous assumez l'absence de vérification. Omettre le champ reste refusé. En cas de désaccord, l'envoi est refusé (recipient_mismatch) et rien ne part. | |
| conversation_id | No | Identifiant de la conversation (conversation_id). Recommandé. |