CONVIRO
E-Commerce

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…

Conviro
18 de novembro de 20268 min de leitura
Extensão de chat para Magento 2 com IA e gratuita: o que faz a Conviro for Magento e como configurá-la
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-basic ficam no auth.json do 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.

Partilhar:

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.

Artigos relacionados

Mais publicações