Linx Commerce

A integração com a Linx Commerce conecta sua loja à OctaSend pela API de integração da Linx (Layer). Com ela você:

• Dispara comunicações a partir dos eventos de pedido (criado, pago, faturado, enviado, entregue, cancelado e qualquer status que a sua loja use), de cliente novo e de carrinho abandonado.
• Sincroniza clientes, pedidos e produtos com o menu E-commerce e alimenta as automações.
• Mostra o Conteúdo Rico nas páginas de produto da vitrine, pela OctaTag.

A integração é somente leitura sobre os dados da loja. A única escrita na Linx é retirar da fila de integração os itens já consumidos, que é o protocolo da própria fila. O funcionamento geral do mapeamento, do histórico e dos status é o mesmo da Nuvem Shop.

​

Antes de começar

Faça no Admin da Linx:

​

Conectar

Regras da conexão:

• Se a Linx recusar o usuário ou a senha depois da conexão, a integração fica Com erro e pede para você atualizar a conexão.
• Se a fila deixar de existir na Linx, a integração também fica Com erro: recrie a fila e atualize a conexão.
• Uma integração guarda os dados de uma loja Linx. Depois de conectada, não dá para trocar o endereço da Layer por outra loja na mesma integração: para conectar uma loja diferente, fale com o suporte. O mesmo endereço em outro formato (com https://, maiúsculas ou barra no final) é aceito.
• Uma instalação Linx com várias lojas (sites) usa uma só conexão.

​

Importação inicial

Ao salvar a conexão, a OctaSend importa em segundo plano os clientes, os produtos e os pedidos dos últimos 90 dias. Essa importação:

• não envia mensagem: só o que acontecer depois da conexão dispara;
• é retomável: se a Linx ficar fora do ar ou o tempo de execução acabar, ela continua de onde parou no minuto seguinte;
• tem seu andamento na lista de integrações e abaixo do título da tela de mapeamento: Importação em andamento, Importação concluída em dd/mm ou Importação com erro;
• vai para erro se a Linx ficar indisponível por mais de 24 horas, ou se 5 tentativas seguidas não avançarem. Para recomeçar, abra Editar conexão e salve de novo.

Lojas com muitos pedidos levam horas para importar, e os eventos da fila continuam saindo enquanto isso.

​

Mapear os eventos

Com a loja conectada, clique em Configurar eventos no card e escolha a comunicação de cada evento. Evento sem comunicação não dispara nada. Os eventos também servem de gatilho nas automações. Na Linx não há aba Rotinas: os dados chegam pela fila.

• Status padrão e status da sua loja. Os eventos fixos são ligados pelo número do status padrão da Linx (não pelo nome). Se a sua loja renomeou ou recriou os status, use as linhas Status: (nome), que acompanham os status que você cadastrou.
• Uma vez só. Cada evento sai uma vez por pedido, cliente ou carrinho. Reprocessar o mesmo item nunca reenvia.
• Só o que aconteceu depois da conexão dispara.
• Um pedido que muda de status gera o evento fixo do novo status (quando existe) e a linha Status: (nome) dele. Mapeie só uma das duas se não quiser mensagem duplicada.

​

Quem recebe a mensagem

O destinatário prefere o celular e cai para o telefone fixo. O e-mail vai junto para os canais de e-mail. Sem e-mail e sem celular, o evento aparece como Ignorado.

​

Variáveis

Em todos os eventos Eventos de pedido Rastreio (eventos de envio e entrega, e linhas Status: (nome)), além das variáveis de pedido Carrinho abandonado (mais as variáveis comuns) Os valores saem no formato brasileiro (R$ 1.234,56).

​

Carrinho abandonado

A Linx marca o carrinho como Abandonado conforme o tempo configurado no Admin da Linx. A OctaSend confere os carrinhos a cada 5 minutos e envia a comunicação mapeada em Carrinho abandonado para quem tem e-mail ou celular.

• Não precisa de script na loja.
• Só entram carrinhos que ficaram abandonados nas últimas 24 horas: depois de uma pausa longa da integração, carrinhos mais antigos não disparam.
• Na hora do envio, a OctaSend confere o carrinho de novo. Se ele já foi convertido em pedido ou não está mais abandonado, o envio aparece como Ignorado (“Carrinho convertido”).
• A mensagem leva o endereço da loja, não um link para retomar o carrinho.
• Diferente da Wake, o carrinho da Linx passa pelo fluxo normal: vale no mapeamento, nas automações e no passo Aguardar evento.

​

Tempo até a mensagem sair

Quando um item da fila falha, a OctaSend espera mais a cada tentativa (1, 2, 4, 8, 16, 32 e 60 minutos, sem passar disso), em vez de insistir a cada minuto. Um item com erro de dado é descartado na 10ª tentativa, com o motivo no histórico. Um item com erro temporário nunca é descartado: se passar de 24 horas assim, o histórico registra um aviso e a OctaSend continua tentando. Uma vez por dia, a OctaSend também confere os pedidos alterados desde a última conferência, olhando no máximo 72 horas para trás, o que cobre uma fila apagada, pausada ou esvaziada por engano.

​

OctaTag e Conteúdo Rico na vitrine

A Linx não permite que outro sistema instale scripts na loja, então você cola o código da OctaTag uma vez. A OctaSend não altera o tema nem a descrição dos produtos. Os códigos ficam no cartão OctaTag na loja, em Configurações → Integrações → Linx Commerce, e só quem pode editar a integração os vê. Use só um dos caminhos. Onde o conteúdo entra:

• Com um Seletor CSS (opcional), logo depois desse elemento. Clique em Salvar seletor para gravar. Como cada tema da Linx é diferente, recomendamos informar o seletor.
• Sem seletor, no fim do <main> da página (ou de [role="main"]). Num tema sem nenhum dos dois e sem seletor, o conteúdo não aparece.

A OctaSend descobre o produto da página nesta ordem: a linha do id do produto; o evento view_item do Tag Manager; os dados estruturados da página (JSON-LD com um único Product). Se a página descreve mais de um produto nos dados estruturados, esse item não é usado, para não mostrar o conteúdo de outro produto. Regras:

• O conteúdo vem do produto da OctaSend com o mesmo ProductID ou SKU da Linx. Produto sem conteúdo publicado não mostra nada.
• Páginas que não são de produto não recebem nada.
• Se você já colou o bloco do Conteúdo Rico à mão no tema (<div data-octasend-content …>), o automático não coloca outro.
• Se você usa a lista de domínios autorizados (Conteúdo Rico › Configuração), inclua o endereço da loja. O cartão avisa quando o endereço salvo na conexão não está na lista.
• Os widgets respeitam o consentimento de cookies configurado na OctaSend.

Para remover, apague o código do Header/Footer ou pause a tag no Tag Manager. Para só parar o Conteúdo Rico automático, desligue o interruptor no cartão.

​

Desconectar

Desconectar, no card, age na hora e sem pedir confirmação. A integração passa a Desconectado, para de ler a fila e as credenciais salvas (usuário e senha da API) são apagadas: para voltar, você informa tudo de novo em Conectar. O mapeamento e os dados já sincronizados no E-commerce são mantidos, e só pode ser reconectada a mesma loja Linx. Ao reconectar, a importação inicial recomeça do zero e só o que acontecer depois da nova conexão dispara mensagem. A OctaSend não remove nada da fila da Linx ao desconectar.

​

Limitações

• A integração ainda não foi validada com uma loja Linx real. A API foi conferida no ambiente demo da Linx, mas o comportamento da fila real e a instalação da OctaTag precisam ser confirmados na primeira loja. Se algo se comportar diferente do descrito, fale com o suporte.
• Não há link de recuperação de carrinho.
• Não há filtro por loja (site) dentro de uma instalação Linx.
• O nome da variável do id do produto no template da Linx ainda não foi conferido: confirme com quem cuida do seu tema. Se a página mostrar {{ … }} no lugar do número, a OctaSend ignora a linha e usa o evento do Tag Manager ou os dados estruturados.
• O Conteúdo Rico é inserido uma vez por página. Se a vitrine trocar de produto sem recarregar a página, o conteúdo pode não acompanhar.

​

Veja também