Integrações externas

Uma migração da aplicação não muda automaticamente os callbacks cadastrados nos fornecedores. Confira domínio, ambiente, loja e conta em cada integração.

Meta e WhatsApp

Configuração	Destino de produção
Webhook principal	https://flow.ecomsmart.com.br/api/v1/webhook/
Endpoint de dados de Flow	https://flow.ecomsmart.com.br/webhook/flow/{tenant_id}
Onboarding/Embedded Signup	Domínios, configuração do app e URLs autorizadas correspondentes ao ambiente.

O verify token é um segredo configurado no ambiente; não é uma senha pública da documentação. A verificação do webhook e a recepção de eventos são etapas distintas. Confira subscriptions/eventos, números, WABA, tokens e permissões do app.

Flows têm configuração própria, incluindo endpoint, IDs e chaves. Alterar o webhook principal não atualiza todos os Flows existentes.

WooCommerce e sincronização

O módulo possui provisionamento de webhooks que cria pares tópico/URL ausentes e utiliza o secret associado ao lojista. Não é necessário assumir que todo lojista deve entrar manualmente no painel: confira primeiro a configuração criada pelo onboarding. A existência de uma URL nova não prova que webhooks antigos/duplicados foram removidos.

Evento	URL pública
Produto criado, atualizado ou excluído	https://flow.ecomsmart.com.br/wc-product-webhook/{merchant_id}
Pedido atualizado	https://flow.ecomsmart.com.br/pay/wc-webhook/{merchant_id}

O gateway reencaminha produtos ao WooCommerce Wrapper e callbacks de pedido/pagamento ao B2C. Validar assinatura, entrega e atualização do índice. Não modificar integrações de ERP ou de terceiros durante essa revisão.

Na primeira conexão, conferir sincronização do catálogo e indexação. Depois, validar atualização com um evento de produto controlado.

Pagamento e frete

Mercado Pago e Melhor Envio são utilizados através da integração WooCommerce e seus plugins nos caminhos consultados. Conferir credenciais, modo de testes/produção, meios habilitados e produtos com peso/dimensões adequados. Não basta alterar a URL do Flow para mudar o ambiente desses plugins.

Interpretar o diagnóstico de conectores

Veja o guia completo do healthcheck para os modos básico/completo, confirmação de efeitos, bloqueio por loja, recuperação e publicação da migration de status.

O diagnóstico reúne oito verificações. Uma execução concluída não significa que todos os itens passaram: conferir os resultados individuais, inclusive os itens Não verificado. Erros de rede não comprovam credenciais inválidas. Ao acionar o suporte, informar a loja, a integração e o horário, sem enviar tokens ou senhas.

Verificação	O que conferir em caso de falha
E-mail / DNS	Endereço cadastrado e DNS do domínio. O teste não valida a existência da caixa nem o envio SMTP.
WooCommerce	URL, chave e segredo no cadastro; permissões em WordPress → WooCommerce → Configurações → Avançado → API REST.
Mercado Pago	Plugin ativo, conexão com a conta e Checkout Pro em WooCommerce → Configurações → Pagamentos.
Melhor Envio	Conexão em WordPress → Melhor Envio → Token e métodos nas áreas de entrega em WooCommerce → Configurações → Entrega. A autorização pertence à conta do lojista; o onboarding do Flow não a substitui.
Meta / Flow / webhook	Conexão WhatsApp Business da loja, publicação do Flow e inscrição do aplicativo. A inscrição não comprova a entrega de eventos; validar também o fluxo real.
Catálogo Meta	Vínculo do catálogo com a conta WhatsApp Business e permissões do aplicativo. Sem catálogo cadastrado, esse recurso não é verificado.
Busca / IA	Sincronização e indexação dos produtos. O teste não valida os modelos de conversação nem todas as chaves de IA.
Número administrador	DDI, DDD e telefone cadastrado; conexão e restrições do WhatsApp central. Envio aceito pela Meta não equivale a entrega confirmada.

Os testes de frete e pagamento criam registros temporários no WooCommerce. Se houver aviso de falha na limpeza, conferir os produtos/pedidos identificados por [EcomSmart Healthcheck] antes de executar novamente. Não remover outros registros da loja.

O painel acompanha por até oito minutos e meio; o servidor admite sete minutos por check e oito minutos por execução. Se a consulta parar, o processamento pode continuar: consulte novamente antes de iniciar outro teste. Os checks selecionados não reutilizam sucesso antigo do cache; resultados preservados por uma reexecução seletiva continuam históricos. O modo básico não cria produtos, pedidos ou mensagens. O completo exige confirmação explícita dos efeitos na loja.

SMTP2GO

Convites, ativação e recuperação de senha utilizam SMTP. O painel permite configurar host, porta, usuário, senha, remetente e TLS. Conferir autorização do remetente, destinatário, log de entrega e URL no corpo do e-mail. A integração antiga com Resend foi removida.

IA

Chaves e seleção de modelos são administradas no painel. Conversação, geração de imagens e embeddings têm capacidades distintas; veja IA e busca semântica.

Homologação

Para HML, usar o domínio flow-hml.ecomsmart.com.br nos callbacks correspondentes e recursos de teste próprios. Não apontar o app Meta nem a loja de produção para HML. Veja o roteiro de preparação.

Aceite de uma configuração externa

1. Registrar conta/recurso e ambiente sem copiar credenciais para tickets.
2. Validar handshake ou conexão.
3. Executar um fluxo controlado e conferir logs de entrada e resultado.
4. Confirmar que eventos chegam ao destino novo e que não há processamento duplicado.
5. Manter contingência até validar os efeitos reais da integração.