Eventos Uappi Ágora

O que é?

O Uappi Ágora é um produto integrado à Plataforma Uappi que permite criar fluxos inteligentes por meio de eventos da loja, conectando o e-commerce a sistemas externos, provedores e modelos de inteligência artificial.

Sempre que uma ação ocorre na loja, como a criação de um pedido, o cadastro de um cliente ou a atualização do status de um pedido, o Ágora pode enviar essas informações para serviços externos, permitindo automatizar processos e integrar diferentes sistemas.

Além dos eventos assíncronos e síncronos, o Ágora também oferece recursos para criação de funções, utilização de templates, integração com provedores e monitoramento das execuções.

---

Para quem serve?

O Uappi Ágora é indicado para lojas, parceiros e desenvolvedores que desejam automatizar processos e integrar a Plataforma Uappi com outros sistemas.

Exemplos de uso:

• Enviar informações para um CRM quando um cliente se cadastra;
• Disparar automações de pós-venda quando o status de um pedido é atualizado;
• Calcular impostos no carrinho por meio de um serviço externo (cenários B2B);
• Integrar a loja com ERPs, plataformas de automação e outros serviços;
• Criar fluxos personalizados utilizando funções e eventos do Ágora

---

Como configurar

1. Acesse o app

No painel administrativo, vá em Apps e abra Eventos Uappi Ágora.

---

2. Configure as credenciais da conta

Na seção Configurações da conta, preencha:

• Account da loja;
• Secret da loja.

Essas credenciais são obrigatórias. Sem elas, os eventos não são enviados.

---

3. Ative os eventos assíncronos

Os eventos assíncronos são avisos enviados sem esperar resposta. A loja notifica o destino e segue o fluxo normalmente.

Marque apenas os eventos que a integração precisa receber:

Evento na tela	Identificador
Pedido criado	uappi.orders.created
Status do pedido atualizado	uappi.orders.status.updated
Cliente criado	uappi.customers.created
Nova inscrição em newsletter	uappi.newsletter.subscription.created
Recuperação de venda enviada	uappi.sales.recovery.sent
Produto criado	uappi.products.created

---

4. Configure os eventos síncronos (se necessário)

Os eventos síncronos são aqueles em que a loja envia a informação e aguarda uma resposta do sistema externo para continuar o processo.

Hoje disponível:

• Calcular impostos do carrinho (uappi.cart.calculate.taxes).

Para cada evento síncrono:

• Defina como Ativo ou Inativo;
• Informe a URL do endpoint que receberá a requisição do evento síncrono. Essa URL deve ser fornecida ou criada conforme a integração utilizada. 
• Salve as alterações.

Atenção: o cálculo de impostos via Ágora só funciona em lojas no modelo B2B.

---

5. Salve e valide

Após salvar, teste o fluxo correspondente (criar pedido, cadastrar cliente, montar um carrinho B2B etc.) para confirmar que a integração está recebendo os eventos.

---

Assíncrono x Síncrono

Assíncrono	Síncrono
Espera resposta?Não	Espera resposta?                  Sim
Impacto no fluxoNão bloqueia a operação	Impacto no fluxo                  Pode influenciar o resultado (ex.: impostos                    no carrinho)
ConfiguraçãoAtivar/desativar por checkbox	Configuração                  Ativo/Inativo + URL do evento

---

Pré-requisitos

• App Eventos Uappi Ágora disponível na loja;
• Account e Secret preenchidos;
• Evento desejado ativado;
• Para impostos no carrinho: loja B2B + URL do evento síncrono preenchida.

---

O que este recurso não faz

• Não substitui integrações de ERP/CRM por completo — apenas dispara eventos conforme a configuração;
• Não envia eventos desativados;
• Não calcula impostos via Ágora em lojas que não sejam B2B;
• Eventos assíncronos não mostram confirmação imediata de recebimento no painel da loja.

---

Perguntas frequentes

Os eventos são enviados automaticamente?

Sim. Com o app configurado, as credenciais preenchidas e o evento ativo, o envio acontece automaticamente quando a ação correspondente ocorre na loja.

---

Posso ativar só alguns eventos?

Sim. Nos assíncronos, basta marcar apenas os que a integração realmente precisa.

---

Preciso configurar URL nos eventos assíncronos?

A URL de emissão dos assíncronos faz parte da configuração da conta do Ágora. Já nos síncronos, cada evento tem sua própria URL.

---

Por que o cálculo de impostos não está funcionando?

Verifique se:

• a loja é B2B;
• o evento está ativo;
• a URL está correta;
• Account e Secret estão preenchidos.

---

O que acontece se o Secret estiver errado?

A autenticação falha e o destino externo não processa o evento corretamente. Confira as credenciais junto ao time responsável pela integração.

---

Como sei se a configuração está correta?

Confirme Account/Secret, eventos ativos e, se for síncrono, a URL. Em seguida, execute um teste prático (ex.: criar um pedido) e valide o recebimento no sistema integrado.

---

Posso desativar o Ágora sem perder a configuração?

Sim. Você pode desativar eventos individuais (ou deixar o app inativo, conforme a política da loja). As configurações preenchidas podem ser reativadas depois, desde que não tenham sido alteradas ou removidas.

---