Troubleshooting de Integração com APIs do SFMC
Separe problemas de autenticação, autorização, payload, rate limiting e estado downstream em integrações externas com SFMC.
O nível de evidência descreve minha experiência com o conteúdo. Fonte oficial descreve contrato/documentação da plataforma. Observação de produção não deve ser tratada automaticamente como limite oficial.
Prove a autenticação uma vez
Valide escopo de client_id/client_secret e auth/base URIs específicos do tenant antes de depurar payload de negócio.
Confirme reuso de token
Garanta que a integração não esteja criando token a cada request nem multiplicando criação de tokens entre workers.
Capture a resposta non-2xx exata
Status code, rota, contexto de correlação e response body sanitizado geralmente vencem qualquer chute.
Trate 429 explicitamente
Respeite Retry-After e exponential backoff. Retry apertado amplifica o incidente.
Valide identidade/schema do payload
Cheque ContactKey/SubscriberKey, EventDefinitionKey, atributos obrigatórios, nullability e formatação de datas.
Cheque idempotência
Se o request for repetido, ele pode criar linhas/eventos/ações duplicadas? Decida isso antes do volume de produção.
Valide o estado downstream
Resposta 2xx prova aceitação do request, mas nem sempre conclusão do processo de negócio. Confirme o objeto/evento/dado resultante no SFMC.