- Dispara comunicações sozinha a partir dos eventos da loja: pagamento aprovado, pedido enviado, carrinho abandonado e outros.
- Sincroniza clientes, produtos e pedidos com o menu E-commerce.
- Alimenta as automações que começam por um evento da loja ou pela chegada de um pedido.
A integração com a Tray está disponível sob liberação. Se o card Tray não aparece em Configurações → Integrações, fale com o suporte.
Onde fica
Em Configurações → Integrações, o card Tray mostra o status, o nome da loja, o Último evento e, em caso de erro, o motivo. Os status são os de Integrações. Cada conta conecta uma loja Tray, e uma loja fica conectada a uma conta só.1. Conectar
Há dois caminhos:- Pela OctaSend: em Configurações → Integrações → Tray, informe o Endereço da sua loja (por exemplo,
minhaloja.com.br, o que aparece no navegador quando você abre a loja) e clique em Conectar com a Tray. Você autoriza o acesso na Tray e volta para a tela Confirmar conexão. Confira o nome da loja e clique em Conectar. - Pela Tray: em Meus aplicativos, instale o aplicativo OctaSend. A Tray leva você à OctaSend e a autorização segue como acima.
2. O que chega da Tray
- Pedidos: a Tray avisa a cada pedido novo ou alterado, e a OctaSend busca o pedido completo, com itens.
- Clientes e produtos: a OctaSend busca os alterados a cada 30 minutos. O aviso imediato desses itens depende de a Tray liberá-lo para a OctaSend; até lá, vale a busca periódica.
- Conciliação diária: uma vez por dia a OctaSend revisa os pedidos e recupera o que um aviso possa ter perdido.
- Importação ao conectar: os pedidos dos últimos 90 dias, depois todos os clientes e produtos. A importação não envia mensagem. Em loja grande ela leva mais de um dia, porque respeita a cota diária da Tray, e retoma de onde parou.
3. Mapear os eventos
Clique em Configurar eventos. Na aba Mapeamento de eventos, cada evento recebe uma comunicação; evento sem comunicação não dispara nada. Crie suas comunicações antes em Comunicações.
Como a Tray não tem um campo de entrega nem de cancelamento, Pedido entregue e Pedido cancelado dependem do nome que você deu ao status na loja.
Regras
- Uma mensagem por transição: pago, enviado, entregue, cancelado, mudança de status e boas-vindas saem uma vez por pedido (ou cliente), mesmo que a Tray repita o aviso.
- Pedido anterior à conexão: pedido, cliente e carrinho de antes da conexão nunca recebem mensagem pela importação. Uma mudança que acontece depois da conexão gera mensagem mesmo em pedido antigo (um pedido importado que é enviado amanhã recebe “enviado”).
- Marketplace não recebe mensagem: pedidos de marketplace (Mercado Livre e outros que a Tray agrega) são sincronizados, mas não geram mensagem. Pedidos da loja virtual e pedidos criados pelo painel, pela API ou por um ERP recebem.
- Pedido alterado, produto alterado e produto excluído só atualizam os dados na OctaSend.
- A comunicação precisa de um canal ativo compatível com o contato do pedido. Sem e-mail nem telefone, o evento fica como Ignorado. O telefone é o celular do cliente e, se não houver, o fixo.
4. Variáveis do template
O painel Variáveis disponíveis mostra as variáveis do evento, com botão para copiar. Todos os eventos
Eventos de pedido (criado, pago, enviado, entregue, cancelado e mudança de status), além das acima
Em enviado, entregue e mudança de status existem ainda
{{codigo_rastreio}} e {{link_rastreio}}. O link pode vir vazio: monte o texto de modo que faça sentido só com o código.
Carrinho abandonado, além das de todos os eventos: {{carrinho_itens}}, {{carrinho_total}}, {{link_retomada}}, {{primeiro_item_nome}} e {{primeiro_item_imagem}}.
Uma variável que não existe no evento não é substituída; uma que existe e a Tray não preencheu chega vazia.
Carrinho abandonado
A Tray não avisa abandono: a OctaSend detecta.- Só carrinho com cliente identificado.
- O carrinho precisa estar parado há mais que o tempo de abandono: padrão 60 minutos, ajustável de 30 minutos a 24 horas no campo Considerar abandonado depois de, na aba Rotinas (clique em Salvar alterações). O interruptor Ativa da mesma seção liga e desliga o envio: desligado, nenhum carrinho é enviado.
- A OctaSend consulta os carrinhos a cada 5 minutos.
- Uma mensagem por carrinho.
- Carrinho convertido não recebe: antes de enviar, a OctaSend confere se o cliente fez um pedido depois da última atividade do carrinho. Na dúvida, não envia, e o evento fica como Ignorado (“Carrinho convertido”).
{{link_retomada}}leva o cliente de volta ao carrinho na loja.
5. Rotinas e Executar agora
Na aba Rotinas:
Executar agora atualiza os dados guardados e não reenvia mensagens. Se a execução parar no limite de tempo ou de cota, a aba avisa e a próxima execução continua de onde parou. Cada execução aparece na aba Logs; a aba Eventos recebidos mostra o resultado de cada evento (Enviado, Ignorado, Falhou).
6. Limites da Tray
- A Tray permite 180 requisições por minuto e 10 mil por dia por loja, divididas com outros aplicativos instalados. A OctaSend reserva 7 mil por dia.
- Quando a cota aperta, a ordem de prioridade é: pedidos que chegam por aviso, carrinho abandonado, clientes e produtos e, por último, a importação inicial.
- Quando a cota do dia acaba, as rotinas voltam no dia seguinte; um aviso de pedido espera até a meia-noite (horário de São Paulo) e é processado então, sem virar falha.
7. Erros e reconexão
Nos quatro primeiros casos a integração fica Com erro até a reconexão. Para reconectar, clique em Reconectar a Tray, informe o endereço da loja e conecte de novo.
Desconectar
Ao desconectar, a OctaSend para de ler a loja. Os pedidos, clientes e produtos já importados continuam na OctaSend. Para voltar, conecte de novo.Veja também
Integrações
As plataformas disponíveis e o que muda entre elas
Nuvem Shop
Telas de eventos, logs e rotinas, iguais às da Tray
E-commerce
Clientes, pedidos e produtos sincronizados da loja
Automações
Sequências de mensagens a partir de eventos da loja