Referência da API

Webhooks — ingestão

Envie eventos de sistemas de terceiros para o PipeCor de forma padronizada e idempotente.

Registrar um evento

POST/api/v1/webhooks/{provider}

Requer webhooks:write. O caminho {provider} é um rótulo livre que identifica a origem (ex.: erp, zapier, meu-sistema). O corpo é gravado para processamento e a resposta é 202 Accepted.

bash

curl -X POST https://app.pipecor.com/api/v1/webhooks/meu-sistema \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: evento-4821" \
  -d '{ "tipo": "pedido.pago", "pedido_id": "4821" }'

Idempotência

Envie um header Idempotency-Key (ou inclua um external_event_id no corpo). Reenvios com a mesma chave são deduplicados — seguro para reprocessar em caso de timeout, sem criar eventos duplicados.

Este endpoint recebe eventos de terceiros. Para o PipeCor enviar eventos ao seu sistema (ex.: quando um negócio é ganho), use a ação de webhook nas automações — veja Enviar para sistemas externos.