Guia de Integração: Tray Commerce

Conectar a plataforma Tray ao Conversaas permite integrar o histórico de vendas, consultar produtos e realizar recuperação inteligente de carrinhos de clientes da sua loja utilizando nossos agentes.

1. Pré-Requisitos

• Loja ativa e publicada na plataforma Tray.
• Usuário logado necessita ser administrador principal para autorização de aplicativos externos e habilitar os webhooks da loja.

2. Instalação

1. Inicie a conexão através do seu painel do Conversaas: Configurações > Integrações > Tray.
2. Clique no botão Conectar Loja.
3. Você será direcionado para o painel de autorização da sua loja Tray para conceder acesso às APIs de comunicação.
4. Confirme as permissões solicitadas pela tela oficial da Tray e você retornará ao Conversaas com status "Conectado".
5. Logo após autorizar e ser redirecionado de volta, adicione o webhook do Conversaas fornecido abaixo (na seção 4) diretamente no seu painel Tray.

3. Funcionalidades Disponíveis

• Recuperação de Carrinho Abandonado: [DISPONÍVEL] Ao integrar o Webhook, notificações de inatividade de carrinho serão capturadas e processadas pelos bots.
• Notificações de Pedido: [DISPONÍVEL] Receba e envie eventos transacionais como confirmação de autorização de vendas e despachos ao cliente.
• Consulta de Catálogo pelo Agente: [DISPONÍVEL] O bot pode buscar produtos diretamente na base de dados da Tray para sugerir aos contatos.

4. Webhooks

A plataforma Tray requer que você cole a URL do webhook do Conversaas manualmente na sua área administrativa.

URL do Webhook do Conversaas:

https://api.conversaas.com.br/integrations/tray/webhook

No painel da Tray:

1. Acesse Configurações > Integrações > Webhooks.
2. Adicione esta URL.
3. Eventos suportados e que devem estar habilitados:
   • Inclusão/Alteração de Pedido
   • Atualização de Estoque

Exemplo de payload de webhook (Tray Padrão):

{
  "name": "orders",
  "scope_name": "sua loja tray",
  "scope_id": 12345,
  "action": "update",
  "resource": "Order",
  "resource_id": 1212
}

5. Testando a Integração

1. Acesse o front-end da sua loja Tray e simule uma compra via boleto bancário (falso) ou PIX (sem pagar) para criar o pedido e gerar os registros.
2. Após o disparo, no painel Conversaas (área de Integrações e Logs), verifique se as requisições estão como Recebendo Dados.
3. Em caso de falha: confira primeiro se o evento de "Inclusão de Pedido" está realmente em verde/marcado no gerenciador de webhooks da Tray.

6. Perguntas Frequentes da Integração

A integração afeta a performance da loja?
Não afeta. O envio de dados via Webhook é feito via servidores e infraestrutura interna da Tray. Além disso a consulta dos produtos é feita através das APIs de catálogo, ocorrendo "por trás dos panos".

O que acontece se a loja ficar offline?
Enquanto a Tray estiver inacessível temporariamente, as consultas do catálogo vão avisar o bot para lidar com erro. Da mesma forma, os webhooks da Tray farão retentativas (retry) até reconectar, prevenindo perda dos carrinhos.

Como desativar temporariamente sem perder a configuração?
Você pode inativar diretamente as regras e webhooks no seu painel. Além disso, exclua temporariamente ou pause a URL do nosso webhook no seu painel da Tray (Configurações > Webhooks). O histórico e configurações no Conversaas serão mantidos até a reativação.