Exemples

Remplacez yourcompany.helpfalcon.com par l’adresse de votre espace de travail et $TOKEN par un token d’API.

Créer un ticket (API compatible Zendesk)

curl https://yourcompany.helpfalcon.com/zd/api/v2/tickets.json \
  -u "integration@example.com/token:$TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ticket": {"subject": "Order 1042 arrived damaged",
       "comment": {"body": "The box was crushed."},
       "requester": {"name": "Lea Novak", "email": "lea@example.com"},
       "tags": ["damaged", "order"]}}'

Trouver un ticket par votre propre id

curl "https://yourcompany.helpfalcon.com/zd/api/v2/tickets.json?external_id=order-1042" \
  -u "integration@example.com/token:$TOKEN"

Rechercher

curl -G https://yourcompany.helpfalcon.com/zd/api/v2/search.json \
  --data-urlencode "query=type:ticket status:open tags:vip" \
  -u "integration@example.com/token:$TOKEN"

Exporter tous les tickets (API REST, pagination par curseur)

const base = 'https://yourcompany.helpfalcon.com';
let url = `${base}/api/tickets?cursor=&limit=100`;
while (url) {
  const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.TOKEN}`, Accept: 'application/ld+json' } });
  const page = await res.json();
  for (const ticket of page.member ?? page.data ?? []) console.log(ticket.id, ticket.subject);
  url = page.links?.next ? new URL(page.links.next, base).toString() : null;
}

Recevoir un webhook (PHP)

$raw = file_get_contents('php://input');
$ts = $_SERVER['HTTP_X_DESK_TIMESTAMP'] ?? '';
$sig = $_SERVER['HTTP_X_DESK_SIGNATURE'] ?? '';
$expected = base64_encode(hash_hmac('sha256', $ts.'.'.$raw, getenv('DESK_WEBHOOK_SECRET'), true));
if (abs(time() - (int) $ts) > 300 || !hash_equals($expected, $sig)) {
    http_response_code(401);
    exit;
}
$event = json_decode($raw, true);
http_response_code(204);

Pour aller plus loin : webhooks, limites de débit et pagination, la référence de l’API.