Integrações

Webhooks + binds.co

Use este guia como base para qualquer orquestrador (Make, n8n, Pipedream, backend próprio).

Voltar para integrações Referência API
Conceito
Trigger de evento + requisição HTTP autenticada + tratamento de retorno.

Escopo e requisitos

  • Envia pesquisa Sim via chamada HTTP para POST /seeds.
  • Captura respostas Sim via consulta da API por janela de tempo/survey.
  • Requisitos mínimos Orquestrador HTTP (Make, n8n, Pipedream ou backend), token/chave e políticas de retry.
  • Boas práticas Implementar idempotência com response_id e log de status HTTP.

Visão geral

Em qualquer plataforma de automação, a estrutura é a mesma: captar evento, transformar payload e enviar para API da binds.co.

Request padrão

POST https://app.binds.co/api/seeds
Authorization: Basic <base64(token:chave)>
Content-Type: application/json; charset=utf-8

{
  "collector": "<collector_id>",
  "from": {
    "name": "Cliente Exemplo",
    "email": "cliente@empresa.com",
    "phone": "+5511999999999"
  },
  "metadata": {
    "event": "order_delivered",
    "orderId": "PED-10393"
  }
}

Tratamento de resposta

  • 2xx Persistir id/horário do envio e seguir fluxo.
  • 4xx Corrigir payload/credenciais; não insistir sem ajuste.
  • 5xx Aplicar retry com backoff e limite de tentativas.

Retentativa e resiliência

  1. Tentativa 1 imediata.
  2. Tentativa 2 após 30 segundos.
  3. Tentativa 3 após 2 minutos.
  4. Falha final: enviar para fila de revisão/manual.

Segurança

Credenciais
Armazene token/chave no cofre de segredos da plataforma e rotacione periodicamente.