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.
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.
- Receber
Validar e guardar o pedido com identificador.
- Encaminhar
Colocar o trabalho pendente numa fila persistente.
- Registar
Associar contacto, pedido e responsável no CRM.
- 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.
| Campo | Regra proposta | Destino |
|---|---|---|
| submission_id | Único por pedido; preservado nas repetições | Referência externa do pedido |
| Validado; identidade conforme o CRM | Contacto | |
| servico | Valor de uma lista controlada | Tipo de oportunidade |
| mensagem | Texto com limite de tamanho | Descrição do pedido |
| submitted_at | Data e hora com fuso explícito | Momento 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.
{
"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.
| Situação de teste | Comportamento esperado |
|---|---|
| Pedido inválido | Explicar o campo a corrigir; não criar oportunidade incompleta. |
| Mesmo pedido entregue duas vezes | Reutilizar a operação; verificar que não duplicou. |
| CRM indisponível | Manter pendente; repetir de forma limitada e visível. |
| Resposta perdida após gravação | Reconciliar pelo identificador antes de criar novamente. |
| Campo removido no CRM | Suspender 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.
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.