Descreva cada integração como fluxo de dados e responsabilidade, não apenas pelo nome da ferramenta. “Instalar Analytics”, por exemplo, não informa quais eventos serão medidos, quem controla a conta, como evitar tags duplicadas ou como testar.
Modelo para anexar à proposta
| Integração | Gatilho e dados | Origem → destino | Conta/acesso | Responsável | Critério de aceite |
|---|---|---|---|---|---|
| Formulário → CRM | envio válido; nome/email/consentimento | site → CRM | conta do cliente; chave em cofre | fornecedor configura; cliente é dono | lead de teste aparece uma vez, com fonte e data corretas |
| Pedido → pagamento | iniciar/confirmar/cancelar pedido; ID e valor | loja → gateway → loja | conta do comerciante, sandbox | fornecedor integra; cliente credencia | pagamento teste, retorno, falha e cancelamento conciliados |
| GA4/GTM | page_view, generate_lead ou purchase | site/data layer → GTM → GA4 | propriedade do cliente | fornecedor implementa; cliente mantém | Preview e DebugView mostram evento único com parâmetros esperados |
| Agendamento | horário, serviço e contato necessários | site → agenda | OAuth restrito da conta do cliente | partes definem suporte | reserva, cancelamento, fuso e confirmação testados |
Especifique o que será entregue
Para cada linha, peça diagrama do fluxo, campos e finalidade, direção de sincronização, ambiente de teste, comportamento se destino estiver fora, tentativas/duplicação, logs, prazo de suporte e custo de serviço externo. Defina quais dados não devem ser enviados, prazo de retenção e procedimento de remoção/erro. Credenciais devem pertencer ao cliente e ser fornecidas por mecanismo seguro; não coloque senhas ou tokens no PDF da proposta.
Separe implementação inicial de manutenção: atualização de API/plugin, renovação, conector, suporte e monitoramento podem ser cobrados à parte. Se a integração processar dados pessoais, especifique quem decide finalidade, quem executa o tratamento e como cumprir as instruções e os controles acordados; submeta cláusulas jurídicas à revisão apropriada.
Valide antes do aceite
Execute cenário válido, inválido, repetido e indisponibilidade no sandbox. Registre entrada, saída, horário e resultado esperado; depois confirme ausência de duplicação no sistema de destino. Só use dados de teste ou sintéticos até o aceite. A proposta deve nomear responsável por cada correção, data de homologação e evidência de conclusão.
Use este quadro para comparar propostas e veja o hub de contratação. O Sebrae exemplifica contratação de serviço com briefing, escopo e etapas; use desenvolvimento de site pelo Sebrae como referência de etapas, não como contrato-padrão.