Pular para o conteúdo principal
Os SDKs oficiais encapsulam os endpoints públicos /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 
npm i @pilot-status/sdk

import { PilotStatusClient } from "@pilot-status/sdk";

const client = new PilotStatusClient({
  apiKey: process.env.PILOT_STATUS_API_KEY!,
});

const accepted = await client.messages.send({
  templateId: "onboarding-test",
  destinationNumber: "+5511999999999",
  variables: { name: "John" },
});

const message = await client.messages.get(accepted.id);
Parsing de webhook: 
import { parseCustomerWebhook } from "@pilot-status/sdk";

const event = parseCustomerWebhook(payload);

​
Python

Pacote: pilot-status 
pip install pilot-status

import os
from pilot_status import PilotStatusClient

client = PilotStatusClient(api_key=os.environ["PILOT_STATUS_API_KEY"])

accepted = client.messages.send({
    "templateId": "onboarding-test",
    "destinationNumber": "+5511999999999",
    "variables": {"name": "John"},
})

message = client.messages.get(accepted["id"])

​
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.

​
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).

​
Relacionados