Logo Poulpo AIPoulpo AI
AccueilSe connecter
Centre d'aide

Aide & Conseils

Le fonctionnement de l'app d'un côté, les conseils stratégiques de l'autre. Des articles courts, actionnables, sans pavé.

Guide & FAQ — fonctionnement de l'app

API & automatisation
Brancher Zapier, Make ou n8n sur votre calendrier
  • Réglages → Accès API : générez une clé. Elle n'est affichée qu'une seule fois, copiez-la immédiatement.
  • Un seul point d'entrée pour l'instant : POST https://poulpoai.com/api/public/v1/contenus.
  • Envoyez la clé dans l'en-tête Authorization: Bearer poulpo_… (ou X-Api-Key).
  • Le contenu créé arrive en brouillon dans le calendrier : il reste soumis à votre validation.
  • Une clé révoquée cesse immédiatement de fonctionner (401).
Premiers pas
Démarrer avec Poulpo AI en 10 minutes
  • Créez votre compte, puis renseignez la mémoire du projet : logo, charte, ton, niche, cible.
  • Chaque projet reçoit automatiquement son équipe de 8 agents.
  • Au démarrage, le mode est semi-automatique : l'agent prépare, vous validez, l'action part.
  • Quand les résultats vous conviennent, basculez l'agent en mode automatique : il publie et envoie seul, vous gardez la main pour revenir en validation à tout moment.
Comptes & projets
Ajouter, gérer ou supprimer un projet
  • Un projet supplémentaire s'achète depuis la page Facturation, puis doit être activé par un administrateur.
  • Tant que le slot n'est pas octroyé, le bouton « Nouveau projet » reste bloqué avec le message d'attente.
  • Supprimer un projet fait toujours disparaître le tarif le plus bas de votre total : les projets restants se recalculent aux rangs 1 à N-1.
  • Chaque projet garde sa mémoire, sa charte et ses comptes connectés, isolés des autres.
Agents
Paramétrer un agent
  • Page Agents : activez ou désactivez chaque agent, changez son prénom, son avatar et son prompt système.
  • Le modèle IA utilisé se règle agent par agent ; la bibliothèque de modèles fournit des prompts prêts à l'emploi.
  • Un agent désactivé n'exécute plus aucune tâche planifiée.
Agents
Ce que fait concrètement chaque agent
  • Veille : surveille les sites concurrents et sources ajoutées dans « Veille », identifie la niche du projet et rend un compte rendu quotidien.
  • Marketing / Copywriter : rédige les textes, angles et hashtags à partir de la mémoire de marque.
  • Création visuelle & vidéo : génère visuels et vidéos avatar selon la direction artistique.
  • Publication : programme et publie sur les réseaux connectés, avec réessais automatiques.
  • Community Manager : répond aux commentaires et messages, gère les objections.
  • Prospection : source, qualifie et relance les prospects B2B par email.
  • Téléphonie & Messagerie : SMS, WhatsApp et Telegram.
  • Coordinateur : orchestre les autres agents à partir de vos instructions.
Pilotage mobile
Parler directement à son agent
  • Connectez Telegram (ou WhatsApp) dans Connexions, puis liez votre numéro dans les destinataires.
  • Chaque livrable arrive dans le canal avec un aperçu et des boutons : valider, corriger, programmer, rejeter.
  • Vous pouvez aussi envoyer un ordre en langage naturel : « prépare 3 posts Instagram pour la semaine ».
Connexions
Clés API et connexions
  • Les clés sont chiffrées (AES-256-GCM) et conservées même si le service répond mal au moment du test.
  • Un statut « à vérifier » signifie que le service était injoignable : la clé reste enregistrée, retestez-la plus tard.
  • Une clé peut être partagée sur tous les projets ou limitée à une sélection.
Connexions
Connexion des réseaux en un clic (passerelle Zernio)
  • La passerelle Zernio (service hébergé en Union européenne) connecte Instagram, Facebook, TikTok, LinkedIn, Snapchat, YouTube, Pinterest et Threads par autorisation officielle : aucune application développeur à créer, aucun jeton à copier.
  • Créez un compte sur zernio.com, ouvrez les paramètres d'API de votre espace, générez une clé, puis enregistrez-la dans les secrets du projet sous le nom ZERNIO_API_KEY.
  • Une seule clé suffit : l'adresse de l'API est déjà connue. Le secret facultatif ZERNIO_API_URL ne sert qu'à viser une autre base d'API (bac à sable ou région dédiée).
  • Tant que la clé n'est pas renseignée, rien ne change : les comptes s'ajoutent manuellement comme aujourd'hui.
  • Une fois active, la page Connexions affiche un bouton « Connecter » par réseau ; les réseaux non pris en charge (Google Business) restent en saisie manuelle.
  • Si la passerelle refuse une publication, l'application bascule automatiquement sur la connexion directe du réseau.
Facturation
FAQ facturation
  • Trois forfaits fixes : Starter 49 €/mois (1 projet), Pro 99 €/mois (jusqu'à 5 projets), Agence 199 €/mois (jusqu'à 10 projets).
  • Aucun projet supplémentaire à l'unité : au-delà de 5 projets, il faut passer à l'offre Agence.
  • Annuel : 10 mois facturés, 2 mois offerts.
  • Agences : passez en facturation « par projet » pour émettre une facture au nom de chaque client.

Conseils stratégiques — utilisation optimale

SEO
Quoi privilégier en SEO
  • Visez des requêtes de longue traîne liées à votre zone et à votre métier plutôt que des mots-clés génériques.
  • Un article utile de 800 à 1 200 mots par semaine bat dix pages creuses.
  • Soignez titres (<60 caractères), méta-descriptions et maillage interne vers vos pages commerciales.
  • Publiez vos contenus réseaux en écho à vos articles : le trafic social nourrit l'indexation.
Réseaux sociaux
Quels réseaux choisir selon votre activité
  • Local / services (garage, restaurant, artisan) : Google Business, Facebook, Instagram.
  • B2B / services aux entreprises : LinkedIn en priorité, complété par un blog et l'emailing.
  • Produits visuels, mode, food : Instagram et TikTok, formats verticaux.
  • Formation, expertise : YouTube et LinkedIn, formats longs et carrousels.
Réseaux sociaux
Renforcer sa présence : fréquence et cohérence
  • 3 publications par semaine tenues 3 mois valent mieux qu'un pic de 10 posts abandonné ensuite.
  • Gardez un fil rouge : mêmes couleurs, même ton, mêmes rubriques récurrentes.
  • Répondez à chaque commentaire dans les 24 h : l'engagement récompense la réactivité.
  • Analysez les statistiques chaque semaine et rejouez les formats qui performent.
Création visuelle
Quel visuel privilégier selon le réseau
  • Instagram : carré 1:1 ou vertical 4:5, visage humain ou produit en gros plan.
  • Reels / TikTok / Shorts : 9:16, accroche dans les 2 premières secondes, sous-titres systématiques.
  • LinkedIn : carrousel documentaire ou visuel sobre avec une donnée chiffrée.
  • Facebook / Google Business : photos réelles de l'équipe et des réalisations plutôt que des banques d'images.

Documentation de l'API publique

API & automatisation
POST /api/public/v1/contenus — créer un contenu dans le calendrier

En-têtes

Authorization: Bearer poulpo_xxxxxxxxxxxxxxxx
Content-Type: application/json

L'en-tête X-Api-Key: poulpo_… est accepté en remplacement.

Corps JSON

{
  "projetId": "uuid-du-projet",      // ou "marqueId": "uuid-de-la-marque"
  "titre": "Nouvelle offre de printemps",
  "texte": "Le texte du post…",
  "reseau": "instagram",             // instagram | facebook | linkedin | x | tiktok | youtube | gmb | pinterest | threads
  "format": "post",                  // facultatif
  "hashtags": "#printemps #offre",   // facultatif
  "datePrevue": "2026-05-02T09:00:00Z" // facultatif, format ISO 8601
}

Réponse (201)

{
  "ok": true,
  "contenu": {
    "id": "uuid-du-contenu",
    "statut": "brouillon",
    "reseau": "instagram",
    "datePrevue": "2026-05-02T09:00:00Z",
    "marqueId": "uuid-de-la-marque"
  }
}

Codes d'erreur

  • 400 — corps invalide (validation, json_invalide, marque_absente)
  • 401 — cle_invalide : clé absente, inconnue ou révoquée
  • 403 — acces_refuse : projet ou marque n'appartenant pas au titulaire de la clé
  • 500 — creation_impossible : incident côté plateforme

Exemple curl

curl -X POST https://poulpoai.com/api/public/v1/contenus \
  -H "Authorization: Bearer poulpo_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"projetId":"...","titre":"Test","texte":"Bonjour","reseau":"instagram"}'