Commentaire vers DMAPI

Transformez les commentaires « envoyez-moi le lien » en messages privés

Créez une automatisation et FoPost surveille les commentaires de vos comptes Instagram et Facebook. Quand un commentaire correspond, son auteur reçoit une réponse privée dans ses DM, d’abord retenue pour votre approbation, sauf indication contraire.

Obtenir votre clé d’APILire la documentation
POST /v1/automations
curl -X POST https://api.fopost.com/v1/automations \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "9b2f6c1e-...",
    "name": "Price comments to DM",
    "triggerType": "inbox_message",
    "triggerConfig": { "keywords": ["price", "link"], "types": ["comment"], "maxRunsPerDay": 20 },
    "graph": {
      "nodes": [
        { "id": "t1", "kind": "trigger" },
        { "id": "m1", "kind": "send_message", "config": {
          "channel": "private",
          "text": "Hi {{contact.name}}, here is the link you asked for.",
          "buttons": [{ "title": "Shop now", "url": "https://yourbrand.com/shop" }]
        } }
      ],
      "edges": [{ "id": "e1", "source": "t1", "target": "m1" }]
    }
  }'

Correspondance de mots-clés

Un ou tous les mots-clés parmi 20 maximum, sur les commentaires seulement ou sur tous les types de message.

Approbation d’abord

Les nouvelles automatisations retiennent chaque réponse jusqu’à son approbation par une personne avant l’envoi.

Une fois par commentaire

Un commentaire est réservé avant l’envoi du DM, il n’obtient donc jamais deux réponses.

Déclencheur

Choisissez quels commentaires reçoivent un message

Le déclencheur inbox_message se déclenche sur les nouveaux commentaires, mentions, réponses, DM, réponses aux stories et avis. Affinez-le avec des mots-clés, des types de message, des comptes précis ou des publications précises, et choisissez de répondre uniquement aux abonnés ou seulement au premier message d’une personne. Chaque automatisation s’exécute au plus 3 fois par jour par défaut ; portez maxRunsPerDay jusqu’à 20.

Lire la référence du déclencheur
Automatisations exécutées selon un calendrier, sur un flux et sur plusieurs réseaux

Par publication

postIds limite l’automatisation aux commentaires des publications que vous indiquez.

Abonnés uniquement

followersOnly ignore les auteurs de commentaires qui ne suivent pas le compte.

Plafond quotidien

maxRunsPerDay évite qu’une publication virale n’envoie des centaines de messages.

Message

Une réponse privée, rédigée à votre façon

L’étape send_message avec channel défini sur private envoie un DM à l’auteur du commentaire via la réponse privée de Meta. Utilisez {{contact.name}} et {{message.text}} dans le texte, ajoutez jusqu’à 3 boutons de lien ou 13 réponses rapides, et joignez un lien qui reçoit des balises UTM et une redirection comptabilisée. Meta n’accepte une réponse privée que dans les 7 jours suivant le commentaire ; les commentaires plus anciens échouent donc avec ce motif.

Voir l’étape send_message
POST /v1/automations/:id/dry-run
curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../dry-run \
  -H "X-API-Key: $API_KEY"

{
  "would_defer": false,
  "approval_mode": false,
  "steps": [
    { "node_id": "t1", "action_type": "trigger", "status": "completed", ... },
    { "position": 1, "node_id": "m1", "action_type": "send_message", "status": "completed",
      "handle": "out", "error_message": null,
      "output": { "messagePreview": "Hi Jordan, here is the link you asked for.", "channel": "private" } }
  ],
  "drafts": [],
  "total_delay_ms": 0,
  "credits_charged": 0
}

Essai à blanc

Prévisualisez le message sur un commentaire récent. Rien n’est envoyé ni créé.

Liens suivis

Les clics sont comptés et l’URL porte utm_medium=dm.

Fenêtre de 7 jours

La limite de Meta pour les réponses privées, vérifiée avant tout envoi.

Contrôle

Approuvez, mettez en pause et auditez chaque exécution

Sauf si une étape définit requireApproval sur false, chaque réponse attend dans GET /v1/inbox/approvals qu’une personne l’approuve ou la rejette. Activez et désactivez l’automatisation en un seul appel, et lisez son historique d’exécutions pour voir ce qui s’est déclenché, ce qui attend et ce qui a échoué.

Commencer à développer
POST /v1/automations/:id/toggle
curl "https://api.fopost.com/v1/inbox/approvals?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/inbox/approvals/:id/approve -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../toggle -H "X-API-Key: $API_KEY"

{ "id": "f2b7d9a4-...", "active": false }

Historique des exécutions

GET /v1/automations/:id/runs avec le statut, l’heure de début et toute erreur.

Relecture

Relancez une exécution passée après avoir corrigé le message ou le déclencheur.

Versions

Chaque modification enregistrée est une version que vous pouvez consulter ou restaurer.

Commentaire vers DM : vos questions, nos réponses

Quels réseaux prennent en charge le commentaire vers DM ?

Instagram et Facebook. Les réponses privées aux commentaires sont une fonctionnalité de Meta, et les autres réseaux n’offrent pas d’équivalent. La même automatisation peut tout de même répondre publiquement aux commentaires sur d’autres réseaux avec channel défini sur same.

La même personne peut-elle recevoir le message deux fois ?

Pas pour le même commentaire. Le commentaire est marqué avant l’envoi du DM et une automatisation ne se déclenche qu’une fois par commentaire ; les nouvelles tentatives et les exécutions répétées n’envoient donc rien de nouveau.

Est-ce que cela part sans vérification ?

Pas par défaut. Une étape send_message créée sans requireApproval retient chaque réponse pour approbation. Définissez requireApproval sur false pour l’étape quand vous voulez qu’elle parte seule.

Que se passe-t-il pour les commentaires de plus de 7 jours ?

Meta n’autorise pas de réponse privée après 7 jours : l’exécution échoue donc avec ce motif et rien n’est envoyé.

De quelles portées de clé d’API ai-je besoin ?

Créer et gérer des automatisations nécessite la portée automations. Lister et approuver les réponses retenues utilise la portée inbox.

Puis-je lancer une automatisation depuis mon propre système ?

Oui, avec un autre déclencheur. Une automatisation avec le déclencheur api_webhook s’exécute lorsque vous envoyez un POST à /v1/automations/:id/trigger avec son secret dans l’en-tête x-automation-secret.

Développez avec Commentaire vers DM dès aujourd'hui

Le démarrage est gratuit et l'API complète est incluse. Créez une clé et faites votre premier appel en quelques minutes.

Obtenir votre clé d’API