Flux de relance

Lire vos flux de relance et y inscrire des leads.

Un flux (ou campagne) est une séquence de messages WhatsApp, email ou SMS envoyée automatiquement à un lead. Inscrire un lead par l’API déclenche de vrais envois : c’est pourquoi le scope campaigns:write n’est jamais accordé par défaut.

L'objet campaign

Champ Type Description
id uuid Identifiant du flux.
name string Nom.
flow_type string direct_response, click_to_chat, lead_magnet, webinar ou outbound_b2b.
status string draft, active ou paused.
steps array Étapes dans l’ordre : order, channel, delay_minutes, content_template.
created_at datetime Date de création.

Lister les flux

GET /api/platform/v1/campaigns campaigns:read

Retourne les flux du compte avec leurs étapes.

Paramètres de requête

Champ Type Description
status string draft, active ou paused.
limit integer Nombre d’éléments par page, de 1 à 100. Par défaut 25.
cursor string Valeur next_cursor de la page précédente. Voir Pagination.

Exemple de requête

curl 'https://strikespace.net/api/platform/v1/campaigns' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/campaigns', {
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.get(
    "https://strikespace.net/api/platform/v1/campaigns",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/campaigns');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "list",
  "data": [
    {
      "object": "campaign",
      "id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
      "name": "Relance Collection d’été",
      "flow_type": "direct_response",
      "status": "active",
      "steps": [
        {
          "id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
          "order": 1,
          "channel": "whatsapp",
          "delay_minutes": 0,
          "content_template": "Bonjour {{first_name}}, merci pour votre intérêt !"
        }
      ],
      "created_at": "2026-08-20T12:05:00.000Z",
      "updated_at": "2026-09-30T18:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Équivalent pour les agents IA : l'outil MCP list_campaigns.

Récupérer un flux

GET /api/platform/v1/campaigns/:id campaigns:read

Retourne un flux et ses étapes.

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant du flux.

Exemple de requête

curl 'https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54' \
  -H "Authorization: Bearer $STRIKE_API_KEY"
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54', {
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
  },
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import requests

response = requests.get(
    "https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
    ],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 200
{
  "object": "campaign",
  "id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
  "name": "Relance Collection d’été",
  "flow_type": "direct_response",
  "status": "active",
  "steps": [
    {
      "id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
      "order": 1,
      "channel": "whatsapp",
      "delay_minutes": 0,
      "content_template": "Bonjour {{first_name}}, merci pour votre intérêt !"
    }
  ],
  "created_at": "2026-08-20T12:05:00.000Z",
  "updated_at": "2026-09-30T18:00:00.000Z"
}

Erreurs spécifiques

404 Flux introuvable, ou appartenant à un autre compte (not_found).

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Inscrire un lead dans un flux

POST /api/platform/v1/campaigns/:id/enrollments campaigns:write

Démarre le flux pour ce lead : la première étape est planifiée (first_step_at) et les messages partent ensuite automatiquement. Les mêmes règles que dans le dashboard s’appliquent : flux actif et non vide, type de flux et canaux inclus dans votre offre, lead non désinscrit ni bloqué, coordonnée disponible pour le canal de la première étape.

Paramètres de chemin

Champ Type Description
id requis uuid Identifiant du flux.

Corps de la requête (JSON)

Champ Type Description
lead_id requis uuid Lead de votre compte à inscrire.

Exemple de requête

curl -X POST 'https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/enrollments' \
  -H "Authorization: Bearer $STRIKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
  }'
// Node.js 18+ (fetch natif)
const response = await fetch('https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/enrollments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.STRIKE_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80"
  }),
})
const data = await response.json()
if (!response.ok) throw new Error(`${data.error.type}: ${data.error.message}`)
console.log(data)
import os
import uuid
import requests

response = requests.post(
    "https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/enrollments",
    headers={"Authorization": f"Bearer {os.environ['STRIKE_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={
        "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80",
    },
    timeout=10,
)
response.raise_for_status()
print(response.json())
<?php
$ch = curl_init('https://strikespace.net/api/platform/v1/campaigns/e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54/enrollments');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('STRIKE_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'lead_id' => '8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80',
    ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException($body['error']['message'] ?? 'Erreur STRIKE');
}

Réponse

Réponse 201
{
  "object": "campaign_enrollment",
  "campaign_id": "e4da3b7f-bbce-4a45-8f2e-6c1d9b3a7e54",
  "lead_id": "8f14e45f-ceea-4e7a-9a3b-2c1d5e6f7a80",
  "status": "scheduled",
  "first_step_at": "2026-10-16T10:20:00.000Z"
}

Erreurs spécifiques

404 Flux ou lead introuvable, ou appartenant à un autre compte (not_found).
403 Type de flux (plan_required) ou canal (channel_not_in_plan) non inclus dans votre offre.
409 Flux inactif (campaign_inactive) ou sans étape (campaign_empty), lead désinscrit ou bloqué (lead_opted_out).
422 Le lead n’a pas d’email ou de téléphone pour le canal de la première étape.

Les erreurs communes (401, 403 insufficient_scope / plan_required, 429) sont décrites dans Conventions.

Équivalent pour les agents IA : l'outil MCP enroll_in_campaign.

Une question sur l'intégration ? Écrivez à contact@strike.app en indiquant l'endpoint, l'heure et le request_id de la réponse.