Extensão de chat para Magento 2 com IA e gratuita: o que faz a Conviro for Magento e como configurá-la
A Conviro for Magento é uma extensão de chat para Magento 2 gratuita que dá a um assistente de IA preços, stock e estado das encomendas em tempo real. Veja o que faz, o que exige…

Neste artigo
A Conviro for Magento é uma extensão de chat para Magento 2 gratuita que liga a sua loja ao assistente de IA da Conviro. Depois de ligada, o assistente responde aos clientes com preços e stock em tempo real da vista de loja (store view) em que estão, só indica o estado de uma encomenda depois de o cliente provar que a encomenda é sua e passa à equipa tudo o que não consegue resolver.
Descarregar, instalar e atualizar a extensão não custa nada. Para ligar uma loja é preciso um plano Conviro com acesso à API, ou seja, o plano Pro ou superior.
Neste artigo: funcionalidades, versões testadas, instalação com Composer, o assistente de configuração e a forma como a privacidade e o desempenho foram pensados. Para perceber porque é que o chat de uma loja precisa de dados em tempo real, leia o nosso artigo anterior sobre chatbots de IA para Magento 2.
Pontos-chave
- Extensão gratuita, ligação paga: instalar e atualizar não custa nada; ligar uma loja exige o plano Pro ou superior.
- Dados em tempo real com salvaguardas: as respostas seguem a vista de loja do cliente, a consulta de encomendas exige o número da encomenda e o email do checkout, e as ações sobre encomendas estão desativadas por predefinição.
- Fora do caminho dos pedidos: as páginas da loja não chamam a Conviro a partir de PHP e as encomendas continuam a ser processadas mesmo que a Conviro esteja inacessível.
O que faz a extensão de chat para Magento 2 da Conviro
A extensão dá ao assistente acesso de leitura aos dados da loja que estão por trás da maioria das perguntas de compra, e ainda uma lista curta de ações que só ficam ativas se as ligar deliberadamente.
| Funcionalidade | O que faz | O que controla |
|---|---|---|
| Preço e stock em tempo real | Lê o preço e o stock atuais durante a conversa, na vista de loja, na moeda e no idioma do cliente, incluindo a quantidade vendável do MSI e as variantes de produtos configuráveis | Escolha das vistas de loja e do âmbito da sincronização no assistente de configuração |
| Estado e seguimento da encomenda | Indica o estado e o seguimento a partir da encomenda real | Só depois do número da encomenda + email do checkout; pausa após cinco tentativas erradas numa hora |
| Email de recuperação de carrinho abandonado | Email opcional com link de regresso à página do carrinho | Desativado até o confirmar |
| Ajuda após pagamento falhado | Oferece ajuda uma vez após um pagamento falhado | Desativada até a confirmar |
| Ações sobre encomendas (cancelar, pôr em espera, comentar) | Permite ao cliente pedir uma ação no chat | Desativadas por predefinição; código do cliente + aprovação da equipa |
| Alterações sem API no Magento | Transforma pedidos como uma nova morada de entrega numa tarefa para a sua equipa | A sua equipa trata do assunto |
| Receita influenciada | Apresenta a receita por moeda, identificada como "influenciada" | Painel da Conviro e cartão no admin do Magento |
| Integration Health | Verifica ligação, autenticação, webhooks, catálogo, encomendas, cron, versão e ambiente | Instruções de correção para cada verificação falhada |
Preço e stock em tempo real na vista de loja do cliente
O assistente lê o preço e o stock durante a conversa, e não a partir de uma cópia do catálogo que ficou desatualizada durante a noite. Num produto configurável, responde ao nível da variante:
Cliente: "Ainda têm o casaco impermeável em M, azul-marinho?"
Assistente: "Sim, o M em azul-marinho está disponível por 89,00 €. O S em azul-marinho está esgotado neste momento. Quer ver o guia de tamanhos?"
O nosso guia sobre verificar preços e stock com dados da loja em tempo real explica porque é que isto pesa mais do que qualquer ajuste ao prompt.
Estado da encomenda sem expor as encomendas de outros clientes
O assistente só partilha o estado e o seguimento depois de o cliente indicar o número da encomenda e o email usado no checkout. Após cinco tentativas erradas numa hora, as consultas ficam em pausa, por isso adivinhar números de encomenda não leva a lado nenhum.
As ações sobre encomendas ficam atrás de duas verificações
As ações de cancelar, pôr em espera e adicionar um comentário estão desativadas por predefinição. Quando ativa uma delas, o cliente confirma com um código de utilização única enviado para o email da encomenda, a sua equipa aprova ou rejeita o pedido e cada passo fica guardado num registo de auditoria. A IA não consegue cancelar uma encomenda sozinha. Para os prós e contras do cancelamento em self-service, veja o nosso artigo sobre cancelamentos de encomendas no chat.
Receita influenciada e Integration Health
A receita é identificada como "influenciada" e não como "gerada", porque uma conversa antes de uma compra não prova que a compra aconteceu por causa dela. Aparece por moeda no painel da Conviro e num cartão no admin do Magento. O Integration Health executa as verificações acima e explica como corrigir o que falhar.
Requisitos e versões do Magento testadas
A Conviro for Magento suporta o Magento Open Source 2.4.4 e posteriores com PHP 7.4 ou 8.1–8.4. Estas combinações tiveram a instalação testada:
| Magento | PHP | Tema | Estado |
|---|---|---|---|
| 2.4.4-p13 | 8.1 | Luma | Instalação testada |
| 2.4.7-p4 | 8.3 | Luma | Instalação testada |
| 2.4.9 | 8.4 | Luma e Hyvä 1.5.2 | Instalação testada |
| 2.4.0–2.4.3 | n/d | n/d | Manter a extensão 1.3.5 |
| Adobe Commerce | n/d | n/d | Ainda não testado (mesma framework) |
No Hyvä 1.5.2 não foi preciso alterar o tema. O Hyvä Checkout não foi testado, por isso, se é esse o checkout que usa, teste-o em staging. Os orçamentos B2B e as devoluções RMA do Adobe Commerce são usados quando estão disponíveis, mas também não foram testados; quando não estão, esses pedidos passam a ser tarefas para a sua equipa. A página de versões suportadas tem a lista atualizada.
O seu ambiente precisa também de:
- Acesso SSH/CLI e Composer
- Um URL da loja em HTTPS
- Cron do Magento em execução
- HTTPS de saída do servidor para
api.conviro.io - Um plano Conviro com acesso à API (Pro ou superior) para ligar a loja
Como instalar a extensão gratuita para Magento 2 com Composer
Instale primeiro numa cópia de staging, no mesmo modo de deploy que a produção usa. Na raiz do Magento:
composer config repositories.conviro composer https://repo.conviro.io
composer config http-basic.repo.conviro.io api <CONVIRO_API_KEY>
composer require conviro/module-aichat
bin/magento module:enable Conviro_AiChat
bin/magento setup:upgrade
bin/magento setup:di:compile # production mode only
bin/magento setup:static-content:deploy -f # production mode only
bin/magento cache:flush
Pormenores que costumam causar problemas:
- O nome de utilizador do Composer é literalmente
api; a palavra-passe é uma chave de API criada em Developers → API Keys no painel da Conviro. - As credenciais
http-basicficam noauth.jsondo projeto. Mantenha este ficheiro fora do controlo de versões. - Confirme que o módulo está ativo com
bin/magento module:status Conviro_AiChat.
O passo a passo completo está no guia de instalação para Magento 2.
O assistente de configuração em 7 passos: ligar a loja
No admin do Magento, abra Stores › Settings › Conviro Setup. O assistente de configuração em sete passos começa com uma verificação do ambiente e depois trata de:
- Ligação. Clique em Connect to Conviro, aprove a loja no painel da Conviro e o browser volta ao Magento. Nenhuma chave de API ou token é colado no Magento.
- Uma integração com privilégios mínimos. O assistente de configuração cria uma integração Magento (OAuth 1.0a) apenas com o acesso de que a Conviro precisa.
- Vistas de loja. Escolha as vistas de loja que a Conviro pode ver.
- Âmbito da sincronização. Escolha catálogo, stock e encomendas (por predefinição, os últimos 90 dias). As contas de clientes só são sincronizadas se as escolher.
- Ações de IA. Decida que ações o assistente pode executar.
- Verificação. Um evento de teste confirma que a ligação funciona de ponta a ponta.
As definições do chat e o cartão Integration Health estão em Stores › Configuration › Conviro › AI Chat.
Multiloja, privacidade e desempenho desde a conceção
Vistas de loja
As respostas seguem a vista de loja, a moeda e o idioma de cada cliente: um cliente numa vista de loja suíça em francês, por exemplo, recebe preços em CHF e respostas em francês. As vistas de loja que excluir não enviam dados de clientes, encomendas ou carrinhos.
Privacidade e RGPD
- Nomes, moradas e números de telefone não são guardados.
- Os endereços de email só são guardados como hash com chave.
- As eliminações de clientes no Magento chegam à Conviro.
- Os cookies de atribuição precisam de consentimento, por isso acrescente-os à configuração do banner de cookies.
- Depois de desligar a loja, os dados são apagados ao fim de 30 dias, ou de imediato, se o preferir.
O inventário de campos de privacidade lista exatamente os campos envolvidos. As suas obrigações ao abrigo do RGPD dependem da sua configuração; isto não é aconselhamento jurídico.
Desempenho da loja
As páginas da loja não chamam a Conviro a partir de PHP, por isso a geração das páginas nunca fica à espera de uma API externa. O checkout, o registo de clientes e a gravação de produtos escrevem numa fila local que o cron do Magento entrega em segundo plano, e é por isso que o cron é um requisito obrigatório. Se a Conviro estiver inacessível, as encomendas continuam a ser processadas.
Custo, atualizações e desinstalação
A extensão é gratuita. Para ligar a loja é preciso o plano Pro ou superior; consulte os preços da Conviro para ver os planos atuais. Todos os planos pagos começam com um período de teste gratuito de 3 dias (é necessário cartão; se cancelar antes do fim, não é cobrado). No plano Enterprise, a equipa da Conviro instala a extensão sem custo adicional.
Para atualizar, execute composer update conviro/module-aichat e depois os mesmos passos setup:upgrade, setup:di:compile e setup:static-content:deploy (só em produção) e cache:flush. Quando sai uma nova versão, o admin mostra um aviso com o comando exato. A configuração, a chave de API e a integração são preservadas.
Para desinstalar, desligue a loja no assistente de configuração, execute bin/magento module:disable Conviro_AiChat e depois composer remove conviro/module-aichat e bin/magento setup:upgrade.
Perguntas frequentes
A extensão da Conviro para Magento 2 é mesmo gratuita?
Sim. Descarregar, instalar e atualizar a extensão não custa nada. Para a ligar a uma loja, precisa de um plano Conviro com acesso à API, ou seja, Pro ou superior. Todos os planos pagos começam com um período de teste gratuito de 3 dias; é preciso um cartão para o iniciar, e não é cobrado se cancelar antes do fim do período experimental.
A Conviro for Magento funciona com Adobe Commerce?
O Adobe Commerce assenta na mesma framework que o Magento Open Source, mas a extensão ainda não foi testada nele. Os orçamentos B2B e as devoluções RMA do Adobe Commerce são usados quando estão disponíveis e também não foram testados. Se usa Adobe Commerce, instale primeiro numa cópia de staging e acompanhe as atualizações na página de versões suportadas.
O assistente de IA pode cancelar encomendas no Magento sozinho?
Não. As ações de cancelar, pôr em espera e comentar estão desativadas por predefinição. Se as ativar, o cliente confirma com um código de utilização única enviado para o email da encomenda e a sua equipa aprova ou rejeita cada pedido. Cada passo fica guardado num registo de auditoria, e a IA nunca cancela uma encomenda por iniciativa própria.
Primeiros passos
Instale em staging, ligue uma vista de loja e teste perguntas reais: uma variante esgotada, uma consulta de encomenda com o email errado. Se tiver um congelamento de código (code freeze) antes da Black Friday, termine já o trabalho em staging e passe para produção depois do pico. Depois, crie a sua conta Conviro, escolha o plano Pro ou superior e ligue a sua loja.
Publicado por
Conviro
Partilha insights sobre suporte ao cliente com IA, automação de chatbots e estratégias de crescimento SaaS.
Construa um percurso de compra integrado
Explore fluxos de suporte para equipas de e-commerce
Veja como o Conviro liga as perguntas dos clientes, o contexto da encomenda, a automação e a transferência para um humano.


