Ejemplos

Sustituye yourcompany.helpfalcon.com por la dirección de tu espacio de trabajo y $TOKEN por un token de API.

Crear un ticket (API compatible con Zendesk)

curl https://yourcompany.helpfalcon.com/zd/api/v2/tickets.json \
  -u "[email protected]/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": "[email protected]"},
       "tags": ["damaged", "order"]}}'

Encontrar un ticket por tu propio id

curl "https://yourcompany.helpfalcon.com/zd/api/v2/tickets.json?external_id=order-1042" \
  -u "[email protected]/token:$TOKEN"

Buscar

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

Exportar todos los tickets (API REST, paginación por cursor)

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;
}

Recibir 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);

Más detalles: webhooks, límites de uso y paginación, la referencia de la API.