Como Enviar Dados de Formulário do WordPress para Qualquer API Com Webhooks

O WPForms tem um add-on para cerca de quarenta serviços. Mailchimp, Salesforce, Stripe, Google Sheets e o restante da pilha usual estão a uma tela de configuração de distância. O sistema de reservas interno do seu cliente não está.

O add-on Webhooks cobre essa lacuna. Ele pega um envio de formulário e o envia como uma requisição HTTP para qualquer URL que você apontar, no formato que a API receptora espera. Este tutorial detalha a configuração: obtendo os detalhes do endpoint, mapeando seus campos, adicionando autenticação e testando antes que um envio real dependa disso.

Crie seu formulário WordPress agora

Como Enviar Dados de Formulário do WordPress para Qualquer API Com Webhooks

Um visitante envia seu formulário. O WPForms molda as respostas em uma requisição HTTP da maneira que sua API deseja, adiciona seu cabeçalho de autenticação e a envia. Sua entrada ainda é salva no WordPress de qualquer maneira.

Quando um Webhook é a Ferramenta Certa

Verifique primeiro se há um add-on nativo. Mailchimp, Salesforce, Google Sheets, Notion, Airtable e cerca de quarenta outros se conectam em alguns cliques, e essas conexões são mais profundas. Zapier, Make e n8n cobrem a cauda longa de aplicativos SaaS, com um custo por tarefa e mais uma conta na cadeia.

Webhooks são para o resto: um sistema interno proprietário, um serviço regional, o backend personalizado de um cliente, um endpoint que você mesmo escreveu. Eles também não têm limite de transferência, então um formulário que recebe 4.000 envios por mês custa o mesmo que um que recebe 40.

O Que Você Precisará

• WPForms Elite (o addon Webhooks está incluído neste nível de licença)
• Um formulário no seu site
• A documentação da API receptora

Você não escreverá nenhum código. Tudo isso acontece no construtor de formulários.

Etapa 1: Obtenha os Detalhes da API

Pular esta etapa é o motivo pelo qual a maioria dos webhooks falha na primeira tentativa. Na documentação da API, anote:

1. A URL do endpoint, como https://api.example.com/v1/deliveries
2. O método de requisição, geralmente POST para criar um registro
3. O método de autenticação, geralmente uma chave em um cabeçalho como Authorization: Bearer YOUR_KEY
4. Os nomes exatos dos parâmetros. Se a API espera customer_email e você envia email, a requisição é bem-sucedida e o valor desaparece.

Exemplo prático: um cliente florista cujo sistema de despacho de entregas recebe novos pedidos naquele endpoint via POST e espera customer_name, customer_email, customer_phone, arrangement, quantity e order_total. Não existe um plugin WordPress para isso, que é exatamente quando você recorre a um webhook.

Etapa 2: Instale o Add-on e Ative-o

Vá para WPForms » Addons, procure por Webhooks e clique em Instalar Addon. Ele se ativa sozinho.

Em seguida, abra seu formulário, clique em Configurações » Webhooks e ative Ativar Webhooks.

Clique no ícone de lápis para renomeá-lo para algo que você reconhecerá mais tarde, como "API de Despacho".

Etapa 3: Defina o URL da Requisição, Método e Formato

Em seguida, configure estas configurações:

URL da Requisição. Cole o endpoint. Preste atenção ao segmento da versão, pois /v1/ e /v2/ são fáceis de confundir.

Método da Requisição. GET, POST, PUT, PATCH ou DELETE. POST cria um novo registro e cobre a maioria das configurações.

Formato da Requisição. JSON envia application/json e atende à maioria das APIs modernas. FORM envia application/x-www-form-urlencoded, então use-o apenas quando a documentação pedir. Em caso de dúvida, use JSON.

Etapa 4: Adicione seus Cabeçalhos de Autenticação

Finalmente, adicione seus cabeçalhos de autenticação.

Cabeçalhos da Requisição aceita pares de chave/valor. Para um token de portador, use Authorization como chave e Bearer YOUR_TOKEN como valor. Para um cabeçalho personalizado, use o nome que a documentação fornecer, como X-API-Key. Adicione quantas linhas precisar.

O campo Segredo funciona ao contrário, e o WPForms o preenche para você. Ele assina cada requisição de saída para que o servidor receptor possa confirmar que os dados realmente vieram do seu site. Use-o quando você controla o endpoint e pode verificar a assinatura; a maioria das APIs de terceiros o ignora.

Trate o valor do cabeçalho como a credencial que ele é. Qualquer pessoa com acesso ao construtor pode lê-lo, portanto, limite as chaves de API do cliente e as rotacione quando alguém sair do projeto.

Crie seu formulário WordPress agora

Etapa 5: Mapeie seus Campos do Formulário

O Corpo da Requisição é onde o formulário encontra a API. Cada linha combina um nome de parâmetro que você digita com um campo de formulário que você escolhe:

• customer_name → Nome
• customer_email → Email
• customer_phone → Telefone
• arrangement → Arranjo
• quantity → Quantidade
• order_total → Total

Copie os nomes das chaves diretamente da documentação. A capitalização e os underscores importam, e uma incompatibilidade resulta em uma requisição que é bem-sucedida, mas descarta o valor.

Caixas de seleção, seleções múltiplas e campos de endereço enviam valores separados por um duplo pipe (||), então divida essa string no lado do servidor se a API esperar um array.

Escolha Adicionar Valor Personalizado para enviar algo que não seja um campo de formulário, como um parâmetro estático source ou uma tag inteligente para o ID da entrada.

Etapa 6: Adicione Lógica Condicional (Opcional)

Ative Habilitar Lógica Condicional para controlar quando o webhook é acionado. Você pode enviar apenas um tipo de arranjo para a API de despacho ou reter pedidos que não precisam de entrega. Para dois destinos, clique em Adicionar Novo Webhook e dê a cada um sua própria regra.

Etapa 7: Teste Antes de Publicar

Teste em duas etapas.

Primeiro, envie para um inspetor de requisição. Webhook.site e RequestBin geram uma URL temporária que mostra exatamente o que chegou. Cole-a em URL de Requisição, salve e envie o formulário. Seus cabeçalhos e payload aparecem imediatamente, o que indica se os nomes das chaves estão corretos.

Em seguida, mude para o endpoint real, envie novamente e confirme se o registro chegou. Verifique também WPForms » Entradas.

Se estiver com dificuldades, vá para WPForms » Ferramentas » Logs, ative Habilitar Logs e verifique Provedores e Erros em Tipos de Log. Envie novamente e o log mostrará a resposta da API. Desative o registro depois, pois essas entradas podem conter dados que você não quer que fiquem no servidor.

Erros Comuns de Webhook

• 401 ou 403. Autenticação: chave errada, chave expirada, prefixo Bearer ausente ou nome de cabeçalho incorreto.
• 404. A URL: erro de digitação, segmento de versão ausente ou uma barra final que a API rejeita.
• 400 ou 422. A API recebeu a requisição e rejeitou o conteúdo, geralmente um parâmetro obrigatório ausente ou uma data não analisável.
• 200, mas nada aparece. Incompatibilidade do nome da chave: a API aceitou a requisição e ignorou os campos que não reconheceu.
• Nada é acionado. Verifique a lógica condicional: em formulários de várias páginas, o webhook é executado uma vez, após o envio final.

Perguntas Frequentes Sobre Envio de Dados de Formulário WordPress para uma API

Qual plano do WPForms inclui o add-on Webhooks?

Elite. Esse nível também cobre Salesforce, Authorize.Net, ActiveCampaign e Airtable, que é por isso que agências que fazem trabalhos de integração personalizados geralmente o escolhem.

Preciso saber programar para usar webhooks?

Não. Tudo acontece no construtor do WPForms. Você só precisa ler a documentação da API o suficiente para encontrar sua URL, método de autenticação e nomes de parâmetros.

Qual a diferença entre webhooks e os addons Zapier ou Make?

Zapier e Make ficam entre seu formulário e o destino, proporcionando fluxos de trabalho de várias etapas e um grande catálogo de conexões por um custo por tarefa. Um webhook vai direto para o endpoint, funciona com qualquer API e não mede envios.

Um formulário pode enviar dados para mais de uma API?

Sim. Clique em Adicionar Novo Webhook e configure a segunda conexão com seu próprio URL, cabeçalhos e mapeamento. Cada um pode ter sua própria lógica condicional.

Como envio uma chave de API com os dados do meu formulário?

Adicione-a em Cabeçalhos de Requisição como um par chave/valor. A maioria das APIs quer Authorization e Bearer SUA_CHAVE, embora algumas usem um nome personalizado como X-API-Key.

O que acontece se a API estiver indisponível quando alguém envia meu formulário?

O envio ainda é concluído e sua entrada e notificações são enviadas, pois o webhook é uma solicitação separada. Apenas o webhook falha, então adicione monitoramento no lado do receptor para qualquer coisa crítica para o negócio.

Em seguida, Roteie seus Envios para o Lugar Certo Automaticamente

Com a conexão da API funcionando, a próxima etapa é o roteamento em torno dela, para que solicitações de orçamento, perguntas de suporte e inscrições na newsletter cada um vá para um lugar diferente por conta própria. Como Roteamento de Envios de Formulário para Diferentes Listas e Ferramentas com Base nas Respostas tem o passo a passo.

Crie seu formulário WordPress agora

Pronto para criar seu formulário? Comece hoje mesmo com o plugin de criação de formulários WordPress mais fácil. WPForms Pro inclui muitos modelos gratuitos e oferece uma garantia de devolução do dinheiro em 14 dias.

Se este artigo ajudou você, por favor, siga-nos no Facebook e Twitter para mais tutoriais e guias gratuitos do WordPress.