Configurando a integração Magento | Central de Ajuda

1. Visão Geral

A integração Magento OmniChat permite:

Catálogo de produtos na OmniChat (itens vindos do Magento).
Criação de carrinho diretamente no Magento, validando fretes, promoções e descontos.
Sincronização de status dos pedidos: o que for comprado no Magento reflete na OmniChat.
Recuperação de carrinho abandonado: opcional, mas pode ser ativado para campanhas de recuperação diretamente na OmniChat.

Fluxo de configuração

Adicionar integração na OmniChat.
Configurando a Integração no Painel OmniChat.
Instalando e Configurando o Plugin no Magento.
Testando a Integração.

📢 A integração da OmniChat com Magento é compatível para loja Magento versão 2, tanto Adobe quanto Open Source.

1. Adicionando a Integração na OmniChat

Acesse Configurações > Integrações > E-Commerce / ERP.
- Você verá uma listagem de integrações já configuradas. Cada card mostra a plataforma, o status (Ativa, Erro, etc.), a data/hora da última atualização e um botão de Editar.
Clique em Adicionar integração (botão amarelo no canto superior direito).
Surgirá um modal “Selecionar integração”. Escolha Magento.

Dica: Se desejar integrar com outras plataformas (ex. Shopify, VTEX, Linx), basta selecionar a opção correspondente.

Ao confirmar, você será direcionado ao fluxo de configuração da integração Magento dentro da OmniChat.

2. Configurando a Integração no Painel OmniChat

2.1. Tela de Configuração

Na tela de edição da integração Magento OmniChat:

Nome da integração: Pode deixar “Magento OmniChat” ou escolher um rótulo que faça sentido para sua loja.
Times (opcional): Caso trabalhe com equipes ou departamentos, você pode atribuir a integração a um time específico.
URL Base: Geralmente é a URL da sua loja, exemplo https://magento.omni.chat ou https://www.minhaloja.com.br.
Usuário / Senha: Credenciais criadas para a comunicação entre o Magento e a OmniChat.
Utilizar carrinho abandonado (opcional): Se ativar, habilita a criação de campanhas de recuperação de carrinho diretamente pela OmniChat.

Clique em Salvar para confirmar. A integração deve ficar Ativa se as credenciais estiverem corretas.

2.2. Instalação do Plug-in (Geração de Chaves)

Depois de salvar a configuração, vá para a aba Instalação do plug-in:

Você verá duas chaves geradas automaticamente: Chave de acesso (x-api-key) e Chave secreta (x-api-secret).
Copie essas chaves. Elas precisam ser inseridas no plugin Magento OmniChat dentro do painel Magento.
Se necessário, use o botão Reinstalar plug-in para gerar novas chaves ou refazer esse processo.

3. Instalando e Configurando o Plugin no Magento

No seu painel de administração Magento:

Instale o plugin OmniChat. O plugin está disponível em repositórios públicos (GitHub da OmniChat). A instalação pode ser feita via Composer:
```
composer require omnichat/magento2
```
```
php bin/magento module:enable Vendor_OmniChat
php bin/magento setup:upgrade
php bin/magento setup:di:compile
```
Com o plugin instalado, acesse Stores > Configuration no menu lateral do Magento.
Na barra lateral, encontre a seção OMNICHAT. Clique em Settings ou Configurações para abrir a tela de configuração do plugin.
Preencha:
- x-api-key: Cole a “Chave de acesso” copiada na OmniChat.
- x-api-secret: Cole a “Chave secreta”.
- Webhook Url: Geralmente https://magento-api.omni.chat ou a URL fornecida pela OmniChat para sincronizar eventos.
Clique em Save Config para salvar.

Se tudo estiver correto, a comunicação com a OmniChat deve ocorrer normalmente. É recomendável limpar cache e reindexar o Magento após instalar ou atualizar módulos.

Par ver o passo a passo completo da instalação do plugin Magento da OmniChat acesse essa documentação no GitHub: Plugin Mangeto OmniChat.

4. Testando a Integração

Selecione uma atendimento e acesse a funcionalidade de compartilhamento de produtos dentro da OmniChat. Faça a pesquisa. O resultado deve ser os produtos que estão disponíveis na sua plataforma Magento.
Adicione o item ao pedido, siga o fluxo e finalize.
Solicite a cobrança.
O link gerado deverá leva-lo para a página de carrinho da sua loja Magento configurada com o item escolhido já adicionado.

5. Dúvidas Frequentes (FAQ)

Onde encontro o plugin Magento OmniChat?
- No GitHub oficial da OmniChat. Há instruções detalhadas de instalação via Composer.
Posso redefinir as chaves (API Key / Secret)?
- Para isso sua integração deve ser totalmente excluída dentro da plataforma OmniChat e uma nova deve ser adicionada.
Como habilitar Carrinho Abandonado?
- Na tela Configuração da integração Magento OmniChat, marque a opção “Utilizar carrinho abandonado”. Depois, crie as campanhas de recuperação de carrinho na OmniChat.
Status “Erro” na lista de integrações
- Verifique se as credenciais (usuário, senha, chaves) e a URL base estão corretas. Também confira se o plugin foi instalado e configurado no Magento sem erros.
Minha versão do Magento é compatível?
- A integração da OmniChat com Magento é compatível para loja Magento versão 2, tanto Adobe quanto Open Source.

Conclusão

Com esses passos, sua loja Magento está integrada à OmniChat. Você passa a aproveitar o catálogo no chat, montar carrinhos e sincronizar pedidos, potencializando suas vendas e o relacionamento com o cliente. Caso encontre qualquer problema, consulte nossa documentação no GitHub ou entre em contato com o suporte.

Bons negócios!