Fundamentos de Webhooks

Polling vs. Webhooks

O Zapier pergunta periodicamente ao aplicativo Tem algo novo, semelhante a atualizar sua caixa de entrada de e-mail a cada poucos minutos. Essa abordagem de polling está presente na maioria das integrações do Zapier e é fácil de configurar usando opções simples de menu suspenso.

# Event happens in app
    ↓
# [Time passes — 1 to 15 minutes]
    ↓
# Zapier checks and finds the event
    ↓
# Zap runs

Com os gatilhos de webhook, o aplicativo envia dados ativamente para o Zapier no momento em que um evento ocorre.

# Event happens in app
    ↓
# App immediately sends data to Zapier URL
    ↓
# Zap runs instantly

Isso funciona como notificações push no seu celular; no momento em que algo acontece, você é notificado instantaneamente, sem atraso. Requer configuração manual no aplicativo de origem, o aplicativo deve suportar webhooks e pode ser utilizado mesmo quando não existe integração nativa com o Zapier.

Compreendendo Dados de Webhook (JSON)

Quando os dados chegam ao seu webhook, normalmente vêm no formato JSON (JavaScript Object Notation). Não é necessário conhecimento avançado em JSON, mas entender o básico é útil.

Quando isso chega ao seu webhook, Zapier analisa o payload e transforma cada valor em um campo utilizável:

• name → "John Smith";
• email → john@example.com;
• company → "Acme Corp";
• deal_value → 15000.

Esses campos aparecem no seletor de campos assim como dados de qualquer outro gatilho. Webhooks simples enviam apenas alguns campos, facilitando o uso direto, enquanto webhooks complexos enviam dados aninhados com dezenas de campos.

O Zapier geralmente achata dados aninhados para facilitar o acesso. Para valores profundamente aninhados, pode ser necessário um passo de Formatter ou Code para extraí-los, assunto abordado em seções posteriores.

Quando e como usar Webhooks

Utilize webhooks para automação instantânea e em tempo real ou quando um aplicativo não possui integração com o Zapier. Eles são ideais para sistemas internos personalizados, ferramentas SaaS de nicho ou novas e plataformas de pagamento que enviam eventos como compras ou assinaturas. Mesmo aplicativos com integrações nativas ao Zapier podem oferecer webhooks para gatilhos mais rápidos ou dados de eventos mais completos.

Como uma URL de webhook aciona seu Zap diretamente, mantenha-a privada, teste com dados reais e monitore o histórico do Zap para identificar erros. As configurações de webhook geralmente estão localizadas em Integrações, API, Notificações ou Configurações de desenvolvedor no aplicativo de origem.