Integrações do OmniChat

💻 Instalar os aplicativos

O OmniChat roda em Windows, macOS, Linux e Android — é o mesmo sistema, sincronizado em todos. Baixe na página inicial e siga o passo do seu sistema. O aviso de segurança na primeira abertura é normal em apps distribuídos fora das lojas oficiais (ainda sem assinatura paga da Microsoft/Apple) — aparece uma única vez.

🪟 Windows (10 ou superior)

1. Abra o OmniChat-Setup.exe baixado e avance na instalação.
2. Se aparecer "O Windows protegeu o seu PC" (SmartScreen): clique em Mais informações → Executar assim mesmo. Só na primeira vez.
3. Abra o OmniChat pelo atalho, entre com o e-mail da sua empresa e crie seu PIN de 4 dígitos.

🍎 macOS (Intel e Apple Silicon)

1. Abra o .dmg e arraste o OmniChat para a pasta Aplicativos.
2. Na primeira vez: botão direito no app → Abrir → Abrir. Se o macOS bloquear mesmo assim, vá em Ajustes do Sistema → Privacidade e Segurança, role até o final e clique em "Abrir assim mesmo".
3. Entre com o e-mail da empresa e crie seu PIN de 4 dígitos.

🐧 Linux (qualquer distro)

1. Dê permissão de execução ao OmniChat.AppImage: botão direito → Propriedades → Permitir execução como programa — ou no terminal: chmod +x OmniChat.AppImage.
2. Dê dois cliques para abrir. (Também oferecemos .deb para Ubuntu/Debian: sudo dpkg -i omnichat-desktop_*.deb.)
3. Entre com o e-mail da empresa e crie seu PIN de 4 dígitos.

🤖 Android (7.0 ou superior)

1. Toque no OmniChat.apk baixado.
2. Se o Android pedir, permita "Instalar apps desconhecidos" para o navegador — só na primeira vez.
3. Abra o app e entre com o e-mail da empresa. O app funciona offline: mensagens, orçamentos e ações ficam na fila e são enviados sozinhos quando a internet volta.

🔒 PIN e login que não expira

No computador, você loga uma vez só. Ao fechar e abrir o app, ele não pede o e-mail de novo: pede apenas o seu PIN de 4 dígitos — um desbloqueio rápido, criado por você, guardado só no seu computador.

• Criar ou trocar o PIN: botão 🔒 na barra superior do app.
• Esqueceu o PIN? Na tela do PIN, toque em "Esqueci o PIN — entrar de novo pela conta": o app sai da conta com segurança e você loga normalmente e cria um PIN novo.
• Errou 5 vezes? O app trava por segurança e só libera pelo caminho do "Esqueci o PIN".

⬆️ Atualizações

1. Baixe a versão nova na página inicial — o site sempre entrega a mais recente.
2. Instale por cima da anterior (Windows/macOS/Android) ou substitua o AppImage (Linux).
3. Seus dados não se perdem: tudo fica no servidor, e o login/PIN continuam valendo.

Como funciona

O OmniChat recebe as vendas por webhook: toda vez que acontece um evento na sua plataforma (compra aprovada, PIX gerado, carrinho abandonado, reembolso…), ela envia um aviso automático para uma URL sua. O OmniChat lê esse aviso, identifica o cliente pelo telefone/e-mail e dispara o que você configurou — mensagem no WhatsApp, entrada no funil, follow-up da IA.

Cada plataforma tem a sua própria URL de webhook, gerada dentro do painel, com um secret que garante que só a plataforma verdadeira consegue enviar eventos.

Passo a passo geral (vale para todas)

1. No OmniChat, abra Integrações de Vendas (menu lateral).
2. Escolha a plataforma e clique em Gerar URL do webhook.
3. Copie a URL gerada — ela tem esta cara:

   https://shidash.impulsocoworking.com.br/webhook_vendas.php?platform=voomp&secret=SEU_SECRET

4. Cole essa URL no painel da plataforma (os passos exatos estão abaixo, plataforma por plataforma).
5. Faça uma venda de teste ou use o botão de teste da plataforma.
6. Volte ao OmniChat → Integrações de Vendas → Eventos recebidos e confirme que o evento chegou.

🎯 Voomp

1. No painel da Voomp, entre em Produto → Entregas → Sistemas externos → Webhook.
2. Cole a URL do OmniChat (gerada com platform=voomp) nos 3 eventos:
   • Vendas — aprovada, recusada, PIX/boleto gerado
   • Assinatura — renovação, cancelamento, atraso
   • Recuperação — carrinho / pagamento abandonado
3. Salve. Faça uma venda-teste (ou reenvie um evento pela Voomp).
4. Confira em Eventos recebidos no OmniChat.

🛒 Kiwify

1. Painel da Kiwify → Apps → Webhooks → Criar webhook.
2. Em URL, cole a URL do OmniChat (platform=kiwify).
3. Marque os eventos: compra aprovada, PIX gerado, boleto gerado, carrinho abandonado, compra recusada, reembolso/chargeback e assinaturas (se vender recorrência).
4. Salve. A Kiwify envia um evento de teste — confirme em Eventos recebidos.

🔥 Hotmart

1. Acesse app.hotmart.com → Ferramentas → Webhook (API e Notificações), versão 2.0.
2. Clique em Cadastrar Webhook e cole a URL do OmniChat (platform=hotmart).
3. Selecione os eventos: compra aprovada, compra completa, PIX/boleto impresso, compra recusada, reembolso, cancelamento de assinatura e compra atrasada.
4. A Hotmart mostra um HOTTOK (token). Copie-o.
5. No OmniChat → Integrações de Vendas → Hotmart, cole o HOTTOK no campo indicado e salve.
6. Faça uma compra-teste (ou reenvie um evento) e confirme em Eventos recebidos.

🟣 WooCommerce (loja WordPress)

Caminho recomendado — Webhook nativo (sem plugin)

1. Painel WordPress → WooCommerce → Configurações → Avançado → Webhooks → Adicionar webhook.
2. Preencha:
   • Nome: OmniChat  ·  Status: Ativo
   • Tópico: Pedido criado (crie outro para "Pedido atualizado" se quiser mudanças de status)
   • URL de entrega: a URL do OmniChat (platform=woocommerce)
   • Segredo: cole o mesmo secret que está na URL
   • Versão da API: WP REST API v3
3. Salve. O WooCommerce envia um ping de teste → confirme em Eventos recebidos.

Alternativa — com plugin (para regras avançadas)

Instale Uncanny Automator, WP Webhooks ou similar e crie: "Quando um pedido for concluído → enviar POST para {URL do OmniChat}". Use quando quiser filtrar por produto, categoria ou valor mínimo.

📝 WordPress (formulários e leads)

Quando a venda ou o lead nasce de um formulário (Contact Form 7, Elementor Forms, WPForms, Gravity Forms):

1. Instale o plugin WP Webhooks (grátis) ou use o webhook nativo do seu plugin de formulário.
2. Configure a ação: "Ao enviar o formulário → enviar dados para {URL do OmniChat}" (platform=wordpress).
3. Garanta que telefone e e-mail sejam enviados (o OmniChat precisa de ao menos um dos dois).
4. Salve e teste enviando o formulário.

Elementor Pro: no formulário → aba Ações após envio → Webhook → cole a URL do OmniChat.

🔌 Outras plataformas

O webhook do OmniChat é genérico — qualquer plataforma que permita "enviar webhook para uma URL" funciona. É só trocar o platform= na URL e colar no painel dela:

EduzzMonetizzeCakto BraipPerfect PayGuru TictoMercado Pago

Eventos suportados

🌐 Chat com IA no seu site

Você pode colocar um botão de chat flutuante em qualquer site seu (campanha, loja, página de evento): o visitante conversa primeiro com a IA do OmniChat e, quando quiser falar com uma pessoa, aparece o botão "IR PARA O WHATSAPP" — é o cliente quem inicia a conversa no WhatsApp, o que reduz muito o risco de banimento do número.

1. No painel do OmniChat, abra 🌐 Chat do Site e clique em Criar token — informe o nome do site e o canal de WhatsApp vinculado.
2. Copie o token gerado.
3. Cole o token na configuração do widget do seu site (a equipe entrega o trecho pronto junto com o projeto — é colar e publicar).
4. Teste: abra o site, converse com a IA e confira a conversa aparecendo no painel em tempo real.

📤 Enviar mensagens de outros sistemas

Sistemas seus (um site de fotos, um ERP, uma loja) podem enviar WhatsApp e e-mail pelo OmniChat com uma chamada simples — a mensagem sai pelo número da empresa e fica registrada no histórico do painel.

POST https://SEU_OMNICHAT/omnichat_send.php?api_key=SUA_CHAVE
Content-Type: application/json

{ "canal": "whatsapp", "to": "5599999999999", "text": "Olá! Seu pedido está pronto 🎉" }
// ou por e-mail:
{ "canal": "email", "to": "cliente@email.com", "subject": "Seu pedido", "text": "..." }

• A resposta vem em JSON: {"ok":true, "message_id":"...", "conversation_id":123}.
• A chave (api_key) é configurada no servidor do OmniChat — trate como senha e nunca a exponha em página pública.
• A conversa criada aparece no painel como qualquer outra — com funil, IA e follow-up funcionando.

Testar & diagnosticar

• Eventos recebidos (no painel) mostra em tempo real cada webhook que chegou, com o conteúdo. Se você fez uma venda-teste e nada apareceu, o problema está na plataforma (URL errada, secret errado ou evento não marcado).
• Reenviar evento: quase toda plataforma tem um botão "reenviar / testar webhook" — use para não precisar de uma venda real.
• Erro 401/403 no log da plataforma: o secret (ou o HOTTOK, na Hotmart) está diferente do que está no OmniChat. Gere de novo e cole nos dois lados.
• Erro 404: a URL foi copiada incompleta. Copie de novo pelo botão do painel.

Segurança (boas práticas)

• Cada plataforma tem seu próprio secret — não reaproveite o mesmo em várias.
• Suspeitou de vazamento? Gere um novo secret no painel; o antigo deixa de funcionar na hora.
• Mantenha o webhook sempre em HTTPS (a URL do OmniChat já é https).
• Na Hotmart, configure sempre o HOTTOK — é o método oficial de validar a origem.