Como ligar um formulário do site ao CRM sem perder pedidos

Ligar um formulário ao CRM deve transformar cada pedido válido num registo que alguém consegue acompanhar. O trabalho inclui definir campos, distinguir contactos de pedidos, lidar com interrupções e confirmar a entrega. Este guia ajuda a preparar essa ligação com a equipa técnica, quer use um conector existente, quer precise de uma integração à medida.

Por Lyntev. Atualizado a .
Cerca de 5 minutos de leitura.

Um pedido com continuidadeA mesma referência acompanha o pedido e evita duplicações.

No final, consegue:

  • Definir o contrato dos dados
  • Testar repetição e recuperação
  • Estimar tempo com exceções incluídas

Desenhe o percurso completo de um pedido

Escolha um formulário e um destino. Por exemplo: pedido de orçamento, criação ou identificação do contacto, abertura de oportunidade e atribuição a um responsável. Confirme primeiro se o CRM já oferece uma ligação que cobre este percurso, os campos necessários e um histórico de falhas consultável.

Separe o recibo ao visitante da conclusão no CRM. Numa integração com processamento posterior, «pedido recebido» só deve aparecer depois de o pedido ficar guardado de forma recuperável. A equipa precisa de distinguir recebido, pendente, concluído e a rever. Um email de aviso, sozinho, não demonstra que o CRM recebeu tudo.

Um percurso que permite recuperar interrupções
  1. Receber

    Validar e guardar o pedido com identificador.

  2. Encaminhar

    Colocar o trabalho pendente numa fila persistente.

  3. Registar

    Associar contacto, pedido e responsável no CRM.

  4. Confirmar

    Guardar o resultado e tornar as exceções visíveis.

Proposta de arquitetura a adaptar ao conector e às garantias do fornecedor.

Defina um contrato para cada campo

Escreva o nome, tipo, obrigatoriedade e destino dos campos antes de ligar aplicações. Um pedido e um contacto são entidades diferentes: a mesma pessoa pode enviar dois pedidos legítimos. O identificador da submissão acompanha o pedido; o identificador do CRM acompanha o contacto.

A API de contactos da HubSpot documenta operações com email ou propriedades únicas, conforme a operação utilizada. Confirme a regra do seu fornecedor e a política de atualização. Não una pessoas apenas por terem o mesmo nome nem substitua dados já confirmados por campos vazios de um formulário.

Defina um contrato para cada campo
CampoRegra propostaDestino
submission_idÚnico por pedido; preservado nas repetiçõesReferência externa do pedido
emailValidado; identidade conforme o CRMContacto
servicoValor de uma lista controladaTipo de oportunidade
mensagemTexto com limite de tamanhoDescrição do pedido
submitted_atData e hora com fuso explícitoMomento de receção

Valide no servidor e limite os acessos

A validação no navegador ajuda a corrigir erros durante o preenchimento. A MDN explica por que motivo essa validação também precisa de existir no servidor: o envio pode chegar por outro caminho. Valide tipos, campos permitidos e tamanhos; devolva mensagens que permitam corrigir o pedido.

As credenciais do CRM ficam no servidor, com as permissões necessárias à operação. Defina proteção contra abuso e o prazo de conservação dos dados de diagnóstico. Nos registos técnicos, prefira identificadores e estados à cópia integral de mensagens pessoais. Um pedido de orçamento também não deve alterar automaticamente preferências de marketing.

Exemplo fictício do contrato de um pedidojson
{
  "version": 1,
  "submission_id": "demo-00042",
  "submitted_at": "2026-11-17T10:15:00Z",
  "contacto": { "nome": "Ana Exemplo", "email": "ana@example.com" },
  "pedido": { "servico": "manutencao", "mensagem": "Pedido fictício." }
}

Faça uma repetição produzir o mesmo resultado

Uma interrupção pode acontecer depois de o CRM guardar o registo, mas antes de a confirmação chegar ao site. Reenviar sem verificar pode criar um duplicado. A documentação de webhooks da Stripe descreve repetições e eventos duplicados; é um exemplo de comportamento que deve confirmar no contrato do fornecedor utilizado.

Peça um mecanismo de idempotência: reconhecer uma operação já aplicada e devolver o resultado existente. A reserva do identificador deve suportar duas tentativas simultâneas. Se a operação tiver várias etapas, guarde o progresso e só assinale conclusão depois das etapas obrigatórias. Quando o destino não oferece uma chave única adequada, é necessário definir como reconciliar resultados incertos.

Decida antecipadamente o que acontece quando falha

As tentativas automáticas precisam de intervalos, limite e uma saída para revisão humana. Respeite as indicações do fornecedor para limites de utilização. Defina quem recebe o alerta, onde consulta o pedido e como retoma o processamento sem voltar a introduzir os dados.

No piloto, compare os pedidos válidos recebidos com os concluídos, pendentes e encaminhados para revisão. Cada identificador deve ter um estado explicável. Faça também um ensaio de recuperação: restabelecer a ligação tem de permitir concluir os pedidos pendentes sem criar novos pedidos.

Decida antecipadamente o que acontece quando falha
Situação de testeComportamento esperado
Pedido inválidoExplicar o campo a corrigir; não criar oportunidade incompleta.
Mesmo pedido entregue duas vezesReutilizar a operação; verificar que não duplicou.
CRM indisponívelManter pendente; repetir de forma limitada e visível.
Resposta perdida após gravaçãoReconciliar pelo identificador antes de criar novamente.
Campo removido no CRMSuspender a tentativa inválida e avisar o responsável.

Estime o tempo incluindo as exceções

Neste cenário fictício, 200 tarefas por mês a 4 minutos representam 13 horas e 20 minutos. Se 80% forem elegíveis, ficam 160 tarefas a rever durante 0,5 minutos e 40 tarefas manuais a 4 minutos. Somando uma hora mensal de acompanhamento, o novo total é 5 horas: a diferença potencial é 8 horas e 20 minutos.

Use o simulador com medições do seu processo. A estimativa não inclui automaticamente configuração inicial, aprendizagem ou incidentes extraordinários, nem converte tempo em dinheiro. A diferença pode ser negativa. Compare a projeção com o piloto e ajuste a percentagem elegível quando descobrir exceções reais.

Entregue uma ficha que permite implementar e verificar

Preencha esta ficha antes da implementação. Depois do piloto, acrescente os resultados dos testes e a pessoa responsável pela continuidade. Uma ligação fica mais fácil de manter quando a equipa conhece os campos, os estados e o procedimento de recuperação.

Ficha para o seu projeto

Ficha da ligação formulário–CRM
Formulário de origem e finalidade:
CRM, objeto de destino e responsável:
Campos obrigatórios e regras de atualização:
Identificador único de cada pedido:
Regra para encontrar ou criar o contacto:
Estados: recebido / pendente / concluído / a rever
Onde fica guardado um pedido ainda não entregue:
Limite de tentativas e destino dos alertas:
Como reconciliar uma resposta perdida:
Prazo de conservação dos dados técnicos:
Testes: válido / repetido / simultâneo / indisponibilidade / recuperação
Contagem de pedidos recebidos e destino de cada um:
Tempo manual medido, exceções e acompanhamento:
Responsável pela aprovação e data:

Faça uma estimativa do tempo de trabalho

Compare o esforço atual com um cenário que inclui revisão humana, tarefas não automatizadas e acompanhamento. Os valores iniciais são um exemplo fictício.

Dados do cenário mensal

Conte ocorrências do mesmo processo num mês representativo.

Tempo de trabalho da equipa, sem contar esperas.

Trabalho humano que continua em cada tarefa automatizada.

As restantes tarefas mantêm o tempo atual.

Manutenção e exceções, além da revisão já contada.

Tempo potencialmente libertado: 8 h 20 min por mês.

Trabalho atual
13 h 20 minPor mês
Trabalho no cenário
5 hPor mês

160 tarefas elegíveis e 40 tarefas mantidas no processo atual.

Como é feita a conta

Tarefas elegíveis = tarefas mensais × percentagem elegível ÷ 100.

Trabalho atual = tarefas mensais × minutos atuais ÷ 60.

Trabalho no cenário = [(tarefas não elegíveis × minutos atuais) + (tarefas elegíveis × minutos de revisão)] ÷ 60 + horas de acompanhamento.

A diferença é o trabalho atual menos o trabalho no cenário. Pode ser negativa. O cálculo admite um volume mensal médio, pelo que a quantidade elegível pode ser fracionária.

Não inclui o esforço inicial de implementação. Tempo libertado não equivale, por si só, a dinheiro poupado: valide os tempos e a qualidade num piloto.

As contas são feitas neste navegador. Os valores não são enviados nem guardados.

Fontes e critérios

Conteúdo elaborado com apoio de IA e pesquisa em fontes técnicas, com revisão dos exemplos e cálculos aplicáveis. As referências apoiam as decisões do guia; os exemplos identificados como fictícios servem para experimentar o método.