Documentation
Bilembo planifie et publie vos posts sur plusieurs réseaux, depuis cette interface, depuis l'API ou avec un assistant.
Démarrage rapide
- Créez votre compte et votre organisation.
- Dans Comptes, connectez au moins un réseau.
- Dans Posts, créez un brouillon, puis planifiez-le.
- Dans Clés d'API, créez une clé si une application ou Hermes doit utiliser Bilembo.
Connecter un compte
Bilembo utilise vos propres applications développeur. Un bouton Connecter n'apparaît que lorsque l'application du réseau est configurée sur l'instance.
- Instagram : le compte doit être professionnel (entreprise ou créateur). Il se connecte par Unified Login de Meta, sans Page Facebook, depuis un portefeuille business, ou avec la Page Facebook à laquelle il est lié.
- TikTok : sans audit de votre application, le compte doit être privé et les vidéos restent privées.
- À reconnecter : le réseau a refusé le jeton. Déconnectez le compte, puis connectez-le de nouveau.
Publier et planifier
Un post part d'un brouillon. Il est publié à l'heure prévue par le planificateur, qui passe chaque minute.
- Instagram : une image ou une vidéo obligatoire, 2 200 caractères. Une vidéo part en Reel.
- TikTok : une vidéo obligatoire, sur un domaine vérifié chez TikTok, 2 200 caractères.
- Facebook : texte, avec une image facultative.
- LinkedIn et X : texte seul, 3 000 et 280 caractères.
Les médias sont des adresses https publiques : Meta et TikTok les téléchargent eux-mêmes. Une vidéo doit se terminer par .mp4 ou .mov.
DM et mots-clés
Un mot-clé déclenche un message privé lorsqu'un commentaire le contient comme mot entier. La réponse est fixe et n'est envoyée qu'une fois par commentaire, dans les 7 jours.
Les DM reçus arrivent dans la boîte de réception. Meta n'autorise une réponse que dans les 24 heures suivant le message.
N'écrivez qu'aux personnes qui vous ont sollicité. Une adresse e-mail récoltée suppose un consentement clair et un désabonnement simple.
API
Chaque appel utilise une clé créée dans l'interface. Les réponses sont en JSON, et les erreurs ont la forme { error, message, details }.
curl -X POST https://votre-instance/api/v1/posts \
-H "Authorization: Bearer bl_live_…" \
-H "Content-Type: application/json" \
-d '{"text":"Bonjour","accountIds":["<id>"],"scheduledAt":"2026-11-02T10:00:00+01:00"}'| Méthode | Route | Rôle |
|---|---|---|
| GET | /api/v1/accounts | Comptes connectés, sans leurs jetons |
| DELETE | /api/v1/accounts/:id | Déconnecter un compte |
| GET | /api/v1/posts | Liste des posts (status, page, pageSize) |
| POST | /api/v1/posts | Créer un brouillon, un post planifié ou immédiat |
| GET | /api/v1/posts/:id | Détail et résultat par compte |
| PATCH | /api/v1/posts/:id | Modifier le texte, les médias ou la date |
| DELETE | /api/v1/posts/:id | Annuler un brouillon ou un post planifié |
| POST | /api/v1/posts/:id/publish | Publier au prochain passage du planificateur |
| GET | /api/v1/inbox | DM reçus (status, page, pageSize) |
| PATCH | /api/v1/inbox/:id | Marquer un DM SEEN ou IGNORED |
| POST | /api/v1/inbox/:id/reply | Répondre à un DM de moins de 24 heures |
| GET / POST | /api/v1/dm-keywords | Lister ou créer un mot-clé |
| DELETE | /api/v1/dm-keywords/:id | Supprimer un mot-clé |
| GET | /api/v1/outliers | Reels au-dessus de la médiane de leur compte |
Webhook Meta
Dans votre application Meta, déclarez cette adresse avec le jeton META_WEBHOOK_VERIFY_TOKEN et les champs comments et messages :
https://votre-instance/api/webhooks/metaChaque événement est vérifié avec le secret de l'application. Un événement renvoyé par Meta n'est jamais traité deux fois.
Hermes et agents
Hermes tourne sur le serveur, dans un conteneur sans accès depuis Internet, et utilise une clé d'API Bilembo. Il prépare les posts et relève les DM sur Telegram. Rien ne part sans votre validation.
- Sans modèle d'IA : la publication planifiée, le relevé des DM et la recherche des reels qui surperforment, chaque matin.
- À la demande : rédiger un post, proposer une réponse, adapter une idée.
- Sécurité : un message d'inconnu n'atteint jamais automatiquement un agent qui détient la clé de publication.
L'installation est décrite dans le dépôt, dans docs/guide-test-deploiement.md.
Limites
- Pas encore d'envoi de fichiers : les médias sont des adresses publiques.
- Pas encore de statistiques, ni de pages de ressources avec collecte d'e-mails.
- Pas encore d'invitations : une organisation a un seul membre depuis l'interface.
- Meta et TikTok ont leurs propres limites et validations d'application.