Pular para o conteúdo principal

Guia de Integração: Bagy

Mantenha sua loja hospedada na Bagy conectada de forma inteligente ao seu fluxo de CRM. Com a nossa integração robusta, suas taxas de conversão por carrinhos inacabados vão decolar.

1. Pré-Requisitos​

  • Ter um plano da Bagy que ofereça suporte a API e uso de integrações de mercado (Apps Externos).
  • Ter o Conversaas num plano ativo que possua canais extras de integração habilitados.

2. Instalação​

  1. Em uma aba do navegador, acesse seu painel na plataforma Bagy e certifique-se de estar logado(a).
  2. Na aba seguinte, abra o painel do Conversaas e navegue em Integrações > Canais > Bagy.
  3. Clique no botão de Conectar com a Bagy.
  4. Essa ação o levará à tela de permissões de OAuth diretamente no servidor seguro da Bagy.
  5. Autorize e conceda permissão de leitura sobre pedidos e catálogos para o Aplicativo do Conversaas.
  6. Feito isso, o sistema o trará de volta ao nosso painel e exibirá o indicador verde informando Status: Conectado.

3. Funcionalidades Disponíveis​

  • Recuperação de Carrinho Abandonado: [DISPONÍVEL] Captura automatizada de carrinhos perdidos, agindo baseando nas regras de tempo que você ajusta em nossas jornadas.
  • Notificações de Pedido: [DISPONÍVEL] O agente enviará avisos quando pagamentos caírem na sub-adquirente e disparar os status dos correios/transportadora gerados pela Bagy.
  • Consulta de Catálogo pelo Agente: [DISPONÍVEL] A IA do Conversaas lê os produtos base (títulos, descrições breves, estoques) exibidos na sua plataforma da Bagy, entregando orçamentos para os clientes no WhatsApp.

4. Webhooks​

Uma vez logado através do fluxo OAuth com sucesso, o Conversaas gerencia e ativa os eventos (webhooks) necessários via interface sistêmica. Você não precisa usar nenhuma URL externa no painel Bagy ou copiar pedaços de código.

A infraestrutura ativada vai enviar eventos (Post hooks) como:

  • Troca de Estado do Pedido (Novo, Pago, Faturado, Enviado)

Exemplo genérico do corpo JSON (payload) originário da Bagy:

{
  "id": "bagy-order-912",
  "status_code": "paid",
  "total_price": "149.90",
  "customer": {
    "fullname": "Maria da Silva",
    "mobile": "+5511999999999"
  }
}

5. Testando a Integração​

  1. Após confirmar no painel que a luz está verde para a Bagy como "Ativa", crie um pedido usando PIX falso (ou não pague o PIX) em guia anônimo da sua loja.
  2. Acesse seu logista Bagy e verule que o pedido caiu como "Aguardando Pagamento".
  3. Mude manualmente para "Pago" ou "Aprovado".
  4. Vá no Conversaas e veja se o CRM registrou uma conversão, e se no Histórico de Conversas do seu Agente Virtual ele realizou o envio transacional.

6. Perguntas Frequentes da Integração​

A integração afeta a performance da loja?
De maneira alguma. A Bagy usa servidores próprios para transacionar alertas via backend que não bloqueiam ou tornam as listagens de seus clientes no celular mais lentas.

O que acontece se a loja ficar offline?
Nenhuma notificação chegará até o sistema enviar tudo novamente em lotes assim que estabilizado. Porém, qualquer cliente seu chamando nosso número do WhatsApp ainda continuará sendo atendido no fluxo trivial sem problemas (embora orçamentos de catálogo pontuais fiquem lentos e a IA responda amigavelmente pedindo para esperar).

Como desativar temporariamente sem perder a configuração?
Apenas acesse a página de Integrações do painel principal (no Conversaas) e acione a pausa clicando no interruptor para a Bagy. Você manterá seus dados e histórico intactos para a volta.