Omie ERP

O conector Omie recebe alterações do ERP por webhooks e reúne os dados do cliente no Contato360 e no atendimento.

Visão geral

Comece em Configuração: conecte o aplicativo e siga os quatro passos para receber atualizações. Prioridades transforma cobranças, pedidos e estoque em uma fila de ação; Clientes permite segmentar pessoas; Dados reúne as importações; Atividade mostra o que chegou da Omie; e Automações concentra rotinas recorrentes.

Requisitos

App Key e App Secret do aplicativo Omie.
Perfil Administrador na Omie para configurar webhooks.
Acesso ao conector e permissão para configurar integrações no CloudWhats.
Endereço público HTTPS e processamento de eventos disponíveis na instalação.

Conectar e configurar os webhooks

Abra Configurações → Conectores → Omie.
Informe o nome do aplicativo, App Key e App Secret e clique em Validar e conectar.
Na guia Configuração, siga o roteiro Receber atualizações da Omie. O endereço já aparece pronto para copiar.
Copie o endereço ou baixe o arquivo para o administrador ou suporte autorizado.
No Portal do Desenvolvedor Omie, abra Aplicativos → aplicativo desejado → Adicionar novo webhook.
Cole o endereço, selecione todos os assuntos disponíveis dos módulos usados e salve.
Recarregue a sessão Omie, produza eventos de teste e confira o recebimento no CloudWhats.

Guia privado

O arquivo contém o endereço privado de recebimento. Compartilhe apenas com o responsável pela configuração. Ele não contém o App Secret. A confirmação de instalação não substitui o primeiro evento de negócio, que aparece no diagnóstico.

Vínculo com o contato

Importe o cadastro do cliente e, no contexto Omie do Contato360 ou do atendimento, busque por nome, CNPJ/CPF, e-mail ou código e confirme o resultado correto. Nomes parecidos nunca vinculam registros automaticamente. Depois do vínculo, pedidos, títulos e documentos locais passam a compor o contexto.

No próprio título a receber, você pode abrir a segunda via do boleto, consultar o PIX já gerado e copiar o código. Pedidos, NF-e e ordens de serviço permitem abrir os documentos que a Omie disponibilizar. Essas consultas não criam cobranças nem alteram o ERP.

Um vínculo incorreto pode ser removido após confirmação. O histórico registra o responsável e protege contra alterações simultâneas. A remoção do vínculo não altera o cadastro no ERP.

Dados e automações

Em Dados, use Importar visão operacional para iniciar clientes, pedidos, contas a receber e posição de estoque. Ver todos os módulos mostra as demais opções. O progresso se atualiza automaticamente enquanto a página estiver visível; você pode pausar e retomar uma importação. As falhas explicam o próximo passo e preservam o progresso anterior.

Em Prioridades, títulos em aberto são separados entre atrasados e próximos do vencimento, pedidos cancelados são excluídos e o saldo de estoque é comparado ao mínimo informado pela Omie. Se a importação ainda estiver incompleta, a página avisa que os números são parciais.

Em Automações, escolha um assunto processado, um campo real recebido e um critério opcional. Depois defina se a rotina deve criar uma tarefa, registrar uma anotação, enviar uma mensagem ou usar um template aprovado. Envios ao cliente nascem como rascunho para revisão. A execução exige vínculo confirmado e conversa do contato no canal configurado.

Na mesma aba, Consultas e operações automatizadas permite escolher um serviço oficial, programar ou reagir a um evento e usar {{omie_result}} como critério da próxima ação. Rotinas agendadas e alterações no ERP permanecem como rascunho até a revisão no editor.

Diagnóstico e próximos passos

Confira eventos e tentativas no conector usando os filtros e a paginação. Notificações de configuração não exigem preencher campos. Eventos de negócio ainda sem suporte permanecem armazenados para análise. O diagnóstico aponta falhas, atrasos, importações interrompidas e aplicativos aguardando eventos. Na lista geral de conectores, você também pode baixar um diagnóstico com as verificações de cada módulo, incluindo e-mail nativo e WhatsApp.

Consultas e operações exibem o contrato oficial e pedem confirmação antes de alterar o ERP. Quando o resultado ficar incerto, confira o documento na Omie e registre se a alteração foi aplicada, incluindo a referência da conferência. Esse registro não reenvia a operação; a solicitação original continua protegida contra repetição.

Desconectar remove credenciais, eventos, dados locais, vínculos e regras do aplicativo. A assinatura do conector continua ativa e é gerenciada separadamente.

Configuração oficial dos webhooks · Limites oficiais de consumo · Catálogo oficial de APIs