/v1 e ajudam com validação e parsing de webhooks. A autenticação é sempre sua chave de API ps_.
Node.js / TypeScript
Pacote:@pilot-status/sdk
Eventos de webhook que o SDK não conhece
A plataforma acrescenta eventos, e um webhook assinado em"*" recebe um evento novo no dia em que ele sai — antes de você atualizar. A partir da 0.12.0, parseCustomerWebhook não lança erro para um nome de evento que não conhece: devolve { type: "unknown", event, data, raw } (UnknownCustomerWebhookEvent) — event e data como chegaram, raw o corpo inteiro, nada validado. Responda com 2xx e ignore.
event em texto e para um evento conhecido com campos que quebram o contrato. isCustomerWebhookEvent continua estrito: false para um nome de evento desconhecido.
Python
Pacote:pilot-status
{"type": "unknown", "event", "data", "raw"} em vez de lançar erro; identifique-o com is_unknown_customer_webhook_event e responda com 2xx:
WebhookParseError continua sendo lançado para um corpo que não é um objeto com event em texto e para um evento conhecido com campos inválidos. Passe unknown_events="raise" para manter o comportamento antigo; is_customer_webhook_event continua estrito. O flow.response_received, que o parser Python não modela, agora volta como desconhecido em vez de lançar erro.
n8n (integração nativa)
Node oficial da comunidade:n8n-nodes-pilot-status.
Instale pela interface do n8n: Settings → Community Nodes → Install → n8n-nodes-pilot-status. A autenticação usa uma chave de API do Pilot Status.
Para eventos de entrada, adicione o node Pilot Status Trigger ao seu fluxo de trabalho, copie sua URL de webhook e cole como um novo webhook na página Webhooks no painel do Pilot Status. Cada evento assinado então inicia seu fluxo de trabalho. Com All Events selecionado, o Trigger repassa qualquer evento com o corpo intacto — inclusive eventos mais novos que a versão do seu node; com um evento específico selecionado, os demais recebem
200 Ignored event.Boas práticas
- Mantenha a chave de API apenas no backend — nunca em código de navegador.
- Para respostas
429/5xx, tente novamente com backoff exponencial (os SDKs ajudam, mas a política de retentativa fica a cargo do seu sistema).