Como configurar Eventos no Uappi Ágora 1.5

O que são eventos?

Os eventos do Uappi Ágora permitem automatizar processos da Plataforma Uappi por meio do envio de informações para funções personalizadas.

Sempre que uma ação ocorre na loja, como a criação de um pedido ou o cadastro de um cliente, um evento pode ser disparado para executar uma automação ou integração.

O Ágora disponibiliza dois tipos de eventos:

  • Eventos Assíncronos;
  • Eventos Síncronos.

Pré-requisitos

Antes de configurar os eventos, verifique se:

  • O acesso ao Uappi Ágora já foi liberado;
  • Um Provider foi configurado;
  • As credenciais da conta (Account e Secret) estão preenchidas.

Eventos Assíncronos

Os eventos assíncronos executam uma função em segundo plano.

Após o disparo do evento, a Plataforma Uappi continua seu fluxo normalmente, sem aguardar uma resposta da automação.

Eventos disponíveis

EventoIdentificador
Pedido criado                                                   uappi.orders.created
Status do pedido atualizadouappi.orders.status.updated
Cliente criadouappi.customers.created
Nova inscrição em newsletter uappi.newsletter.subscription.created
Recuperação de vendasuappi.sales.recovery.sent
Produto criadouappi.products.created

Eventos Síncronos

Os eventos síncronos funcionam de maneira diferente.

Quando um evento é executado, a Plataforma Uappi aguarda a resposta da função antes de continuar o processo.

Atualmente, está disponível o seguinte evento:

                            EventoIdentificador
Calcular impostos do carrinhouappi.cart.calcuate.taxes

Importante: Atualmente é permitido apenas um evento síncrono por conta.


Como configurar os eventos

1. Acesse o Ágora

Entre no Uappi Ágora e abra a tela de configuração dos eventos.


2. Configure as credenciais da conta

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

  • Account;
  • Secret.

Essas credenciais são obrigatórias para que os eventos possam ser autenticados corretamente.


3. Configure os eventos assíncronos

Selecione apenas os eventos que serão utilizados pela integração.

Após ativados, eles passarão a disparar automaticamente sempre que a ação correspondente ocorrer na loja.


4. Configure os eventos síncronos

Caso utilize o cálculo de impostos do carrinho:

  • Ative o evento;
  • Informe a URL do endpoint responsável pelo processamento;
  • Salve as alterações.

Importante: O cálculo de impostos via Ágora está disponível apenas para lojas B2B.


5. Teste a configuração

Após concluir a configuração:

  • crie um pedido;
  • cadastre um cliente;
  • execute a ação correspondente ao evento configurado.

Verifique se a função foi executada corretamente.


Diferença entre eventos assíncronos e síncronos

          Assíncronos                            Síncronos
Não aguardam respostaAguardam resposta
Executados em segundo planoExecutados em tempo real
Não interrompem o fluxo da lojaPodem alterar o resultado da operação
Podem existir vários eventosAtualmente aceita apenas um evento por conta

Boas práticas

  • Ative apenas os eventos realmente necessários.
  • Mantenha as credenciais da conta atualizadas.
  • Teste todos os eventos antes de utilizá-los em produção.
  • Revise periodicamente as configurações para garantir que continuem atendendo às necessidades da integração.

Perguntas frequentes

Os eventos são enviados automaticamente?

Sim. Após configurados e ativados, os eventos são disparados automaticamente quando a ação correspondente ocorre na Plataforma Uappi.


Posso ativar apenas alguns eventos?

Sim. É possível habilitar somente os eventos necessários para a sua integração.


Os eventos síncronos precisam de URL?

Sim. O endpoint deve ser informado para que o Ágora consiga enviar a requisição e aguardar a resposta.


Posso utilizar mais de um evento síncrono?

Não. Atualmente, o Ágora permite apenas um evento síncrono por conta.


Como confirmar que um evento está funcionando?

Após configurar o evento, execute uma ação correspondente (como criar um pedido ou cadastrar um cliente) e valide se a função foi executada corretamente.

Tags
Social Share

Leave a Reply

Your email address will not be published. Required fields are marked *