Nuvem Shop

A integração com a Nuvem Shop (Tiendanube) conecta sua loja à OctaSend e faz três coisas:

• Dispara comunicações sozinha a partir dos eventos da loja: pedido pago, pedido enviado, cliente cadastrado e outros. Você escolhe numa tela qual comunicação sai em cada evento.
• Sincroniza clientes, produtos e pedidos da loja com o menu E-commerce: na conexão e depois a cada aviso que a loja manda quando algo muda.
• Alimenta as automações que começam por um evento da loja ou pela chegada de um pedido.

​

Onde fica

No menu lateral, abra Configurações → Integrações. O card Nuvem Shop mostra o status da integração, o nome da loja conectada, a data do Último evento recebido e, quando houver, um aviso ou o motivo de um erro. Cada conta OctaSend conecta uma loja Nuvem Shop, e uma loja fica conectada a uma conta só. O que cada pessoa pode fazer nas telas de integração depende do perfil de acesso dela (Configurações → Perfis de acesso, página Integrações): com Editar, ela conecta, configura e desconecta a loja; só com Visualizar, ela vê o card e a tela de eventos, com o aviso “Você pode visualizar, mas não alterar.”, sem os botões que mudam alguma coisa.

​

1. Conectar

Há dois caminhos, e os dois terminam na mesma confirmação:

• Pela OctaSend: siga os passos abaixo.
• Pela loja de aplicativos da Nuvem Shop: instale o app OctaSend na sua loja e autorize. Se você ainda não estiver logado na OctaSend, ela pede login (ou cadastro) e depois volta para a confirmação.

A autorização na Nuvem Shop sozinha não conecta a loja: é a confirmação que conecta. O link da tela Confirmar conexão da loja vale 30 minutos e uma vez só. A tela recusa a conexão quando:

• o link expirou ou já foi usado: instale o app de novo pela Nuvem Shop ou clique em Conectar na tela de integrações;
• o link foi criado em outra conta ou já foi substituído por um mais novo: volte a Integrações e clique em Conectar de novo;
• a loja já está conectada a outra conta OctaSend: desconecte por lá antes de conectar aqui;
• sua conta já tem outra loja conectada: desconecte a loja atual antes de conectar outra.

Ao conectar, a OctaSend:

• Importa o catálogo da loja em segundo plano: clientes, produtos e pedidos, até 10.000 registros de cada tipo. A importação não trava a tela e, se falhar, a conexão continua valendo. Depois, o Executar agora da aba Rotinas traz de novo a lista inteira de clientes e de produtos, mas olha os pedidos de no máximo 30 dias para trás: o histórico de pedidos mais antigo só é importado de novo quando você desconecta e conecta a loja.
• Cria as rotinas de Clientes, Produtos e Pedidos da aba Rotinas. Elas não rodam sozinhas: servem para o Executar agora. Veja a seção Rotinas de sincronização, abaixo.
• Liga a OctaTag e o Conteúdo Rico nas páginas de produto, sem passo extra (veja OctaTag e Conteúdo Rico na vitrine). Se a sua conta ainda não tinha uma chave da tag do site, a OctaSend cria uma chamada Site principal.
• Registra na loja os avisos (webhooks) dos eventos de pedido, cliente e produto, menos Pedido aguardando pagamento, que só é registrado se já estiver em uso; e os avisos de ciclo de vida do app (desinstalação, suspensão e reativação).

Se a autorização na Nuvem Shop falhar, a loja não fica conectada: você volta para Integrações com o aviso A loja não foi conectada. Clique em Conectar de novo para refazer a autorização.

​

2. Mapear os eventos

Com a loja conectada, clique em Configurar eventos no card. A tela Eventos da Nuvem Shop tem cinco abas: Mapeamento de eventos, Rotinas, Logs, Eventos recebidos e Conexão. A aba Conexão concentra os dois interruptores da vitrine, descritos em OctaTag e Conteúdo Rico na vitrine; o botão OctaTag na loja do card (visível para quem pode editar integrações) abre a tela já nessa aba. Na aba Mapeamento de eventos, cada evento da loja tem uma lista para escolher a comunicação que ele dispara. Deixe em Não enviar nada para não enviar. Clique em Salvar para gravar. O código aparece embaixo do nome do evento no mapeamento e identifica o evento nas abas Logs e Eventos recebidos. Regras do mapeamento:

• Cada evento dispara uma comunicação. A mesma comunicação pode ser usada em mais de um evento.
• A lista mostra todas as comunicações da conta, inclusive as inativas. Um evento mapeado para uma comunicação inativa chega, mas não envia nada.
• Salvar grava o mapeamento inteiro: um evento que você voltou para Não enviar nada sai do mapeamento e deixa de disparar comunicação. Ele continua chegando da loja e aparece em Eventos recebidos como Ignorado. Só Pedido aguardando pagamento deixa de ser recebido, a não ser que uma automação ativa use esse evento.
• Se a comunicação escolhida não existir mais, aquele evento não é salvo e a tela avisa quantos ficaram de fora. Revise e salve de novo.
• Ao salvar, a OctaSend só cadastra na loja os avisos que faltam e só remove os que sobraram. Os que já estavam cadastrados continuam chegando, mesmo que a Nuvem Shop recuse um cadastro no meio do caminho.
• Se o mapeamento for salvo mas a OctaSend não conseguir atualizar os avisos na Nuvem Shop, a tela avisa. Nesse caso, salve o mapeamento de novo em alguns minutos; a conferência diária dos avisos também tenta sozinha.
• Com a integração Com erro ou Desconectado, o card mostra só o botão Conectar e o motivo, e a edição do mapeamento fica bloqueada até você reconectar. Se a tela Eventos da Nuvem Shop já estava aberta, ela mostra o motivo, e as abas Logs e Eventos recebidos continuam com o histórico.

Se você ainda não tem comunicações cadastradas, a tela mostra o link Criar comunicação. Crie uma em Comunicações primeiro.

​

Quem recebe a mensagem

• Eventos de pedido: o e-mail e o telefone de contato do pedido. Se o pedido não tiver, a OctaSend usa os do cliente do pedido.
• Eventos de cliente: o e-mail e o telefone do cliente.
• Eventos de produto: a Nuvem Shop não informa nenhum cliente nesses eventos. Mapear uma comunicação para eles não envia mensagem: o evento aparece como Ignorado. Eles servem para manter o catálogo de produtos do E-commerce atualizado.

Telefones sem código de país recebem o código do Brasil (55) automaticamente quando têm 10 dígitos (fixo com DDD) ou 11 dígitos com 9 depois do DDD (celular). Outros telefones de 11 dígitos ou mais são tratados como já tendo o código de país. Um telefone que começa com + mantém o código de país informado. A comunicação escolhida precisa ter pelo menos um canal ativo compatível com os dados que chegaram. O e-mail quase sempre está disponível; o telefone só quando o pedido ou o cliente tiver telefone cadastrado na loja. Uma comunicação só com WhatsApp, por exemplo, não dispara para um pedido que só tem e-mail. Os envios disparados por eventos da loja contam no limite de envio por minuto da sua conta. O que passar do limite é adiado e enviado quando o limite liberar. Eles também contam no Limite diário de mensagens, se a conta tiver um (veja Configurações). As mensagens do mapeamento de eventos são transacionais: saem mesmo para um cliente que se descadastrou do canal, sem o link de descadastro. Veja Descadastro por canal.

​

3. Usar as variáveis no template

O painel Variáveis disponíveis, ao lado do mapeamento, mostra as variáveis do evento selecionado, com um botão para copiar. Clique no nome de um evento (ou escolha uma comunicação para ele) para ver as variáveis. Cole no corpo da comunicação e a OctaSend substitui pelo valor real no disparo. Eventos de pedido Em Pedido enviado existem ainda {{codigo_rastreio}} e {{link_rastreio}}. Eles vêm do envio registrado na Nuvem Shop: se o pedido foi marcado como enviado sem código de rastreio, as duas chegam vazias. Eventos de cliente Eventos de produto Sobre os valores:

• Valores saem no formato brasileiro, com duas casas e sem o símbolo da moeda (1.234,50): escreva o R$ no template. Datas saem como 21/09/2026 22:30, no horário de Brasília. Os status saem em português (por exemplo, Pago, Pendente, Enviado, Cancelado); um status que a OctaSend não conhece chega como a Nuvem Shop o envia.
• Nomes de produtos e de itens cadastrados em mais de um idioma chegam no idioma principal da loja.
• {{loja_nome}} é o nome da loja lido no momento da conexão.
• Uma variável que não existe naquele evento não é substituída: o texto {{nome_da_variavel}} chega como está na mensagem. Se a mesma comunicação atende eventos diferentes, use só as variáveis comuns a todos (por exemplo, {{codigo_rastreio}} só existe em Pedido enviado).

​

4. Acompanhar

​

Eventos recebidos

A aba Eventos recebidos mostra os 50 eventos mais recentes que chegaram da loja, com o código do evento, a data e o que aconteceu com cada um: Motivos comuns de Ignorado: não há comunicação mapeada para o evento, a comunicação mapeada foi excluída ou está inativa, o pedido ou cliente não tem e-mail nem telefone, a comunicação não tem canal ativo compatível com os dados do evento, a mensagem daquele evento já foi enviada para o mesmo pedido, cliente ou produto, ou o evento veio de outra loja que não a conectada. Motivos comuns de Falhou: nenhum canal conseguiu entregar a mensagem, o pedido, cliente ou produto não existe mais na loja, a Nuvem Shop recusou o acesso, ou o evento continuou com falha passageira depois de 6 tentativas. Regras:

• Repetição em menos de 10 minutos: se a Nuvem Shop enviar de novo o mesmo evento para o mesmo pedido, cliente ou produto menos de 10 minutos depois do último que foi registrado, a repetição é descartada e não aparece no histórico. Várias alterações seguidas num pedido, por exemplo, geram um único Pedido atualizado nesse intervalo.
• Mensagem que já saiu não sai de novo: em Pedido criado, Pedido pago, Pedido embalado, Pedido enviado, Pedido cancelado e Cliente cadastrado, que acontecem uma vez para cada pedido ou cliente, a comunicação não é enviada duas vezes para o mesmo pedido ou cliente, mesmo que o evento chegue de novo depois de 10 minutos. A repetição aparece como Ignorado, com o motivo “Mensagem já enviada para este recurso”. Pedido atualizado, Pedido aguardando pagamento e Cliente atualizado podem disparar a cada vez que acontecem.
• Falha temporária: quando a falha é passageira (instabilidade da Nuvem Shop ou da OctaSend), o evento não fica como Falhou de imediato. Ele continua como Recebido e a OctaSend tenta de novo sozinha, depois de 1, 5, 15, 60 e 60 minutos. Se a sexta tentativa também falhar, o evento fica como Falhou, com o último motivo.

​

Logs

A aba Logs junta num só histórico (Histórico de sincronização), do mais recente para o mais antigo, as execuções das rotinas (Rotina: Clientes, Rotina: Produtos, Rotina: Pedidos, com a quantidade de registros quando é maior que zero e o status Sucesso ou Erro) e os eventos recebidos (Webhook: seguido do código do evento, com os mesmos status da aba Eventos recebidos). Aparecem até as 50 execuções e os 50 eventos mais recentes, com a mensagem de erro quando houver. Em cada linha, Ver detalhes abre o resumo (origem, horários, registros processados ou evento e recurso, e o erro) e O que veio: num evento, o aviso que a Nuvem Shop enviou (num evento recuperado pela conferência de pedidos, só a indicação de que veio da conferência e o identificador do pedido na Nuvem Shop); numa rotina, uma amostra de até 20 dos registros recebidos.

​

5. Rotinas de sincronização

Na Nuvem Shop, a aba Rotinas não tem intervalo nem liga e desliga: as rotinas não rodam sozinhas. Clientes, produtos e pedidos chegam pelos avisos que a própria loja envia a cada mudança. Cada rotina (Clientes, Produtos e Pedidos) tem:

• o botão Executar agora;
• a data da Última execução, ou Ainda não executou.

Executar agora é o botão de reparo, para quando você desconfia que algo não chegou (uma queda, um aviso perdido, um aviso apagado no painel da Nuvem Shop) ou quando um produto apagado na loja ainda aparece no E-commerce:

• Clientes e Produtos: buscam a lista inteira da loja e gravam tudo de novo. Em Produtos, o que não está mais na loja é marcado como removido.
• Pedidos: busca os pedidos alterados desde a última vez que você executou, até 30 dias para trás no máximo. Na primeira execução, os últimos 30 dias.

Regras:

• Executar agora só funciona com a integração Conectado. Com a integração Com erro ou Desconectado, o botão fica bloqueado.
• A execução acontece em segundo plano: a tela avisa Sincronização iniciada e o resultado aparece em Última execução e na aba Logs depois que você atualizar a página.
• Cada execução lê até 10.000 registros da loja. Se a lista de produtos chegar a esse teto, nenhum produto é marcado como removido naquela execução.
• As rotinas só atualizam os dados do E-commerce. Elas não enviam comunicações do mapeamento nem disparam automações.

Além do que chega pelos avisos, duas conferências rodam sozinhas, em segundo plano e sem nada para configurar:

• Conferência de pedidos, cerca de uma vez por dia por loja: a OctaSend busca os pedidos alterados desde a conferência anterior (com uma folga de 10 minutos, e até 72 horas para trás) e recupera o que um aviso perdido deixou de fora. Se a conferência falhar, ela é tentada de novo cerca de 30 minutos depois.
• Conferência dos avisos, cerca de uma vez por dia por loja: confirma que a loja ainda tem os avisos registrados e recria só o que sumiu.

​

O que é sincronizado

Os dados da loja chegam ao menu E-commerce (Clientes, Pedidos e Produtos) por quatro caminhos: a importação feita na conexão, cada evento recebido da loja (inclusive quando nenhuma comunicação está mapeada), o Executar agora da aba Rotinas e a conferência diária de pedidos. Cada pedido guarda também os cupons usados, normalizados (sem espaços e em maiúsculas). É isso que permite às popups personalizadas contar as vendas feitas com o cupom de uma campanha. Os pedidos antigos da Nuvem Shop ganharam o cupom a partir dos dados já guardados. Os eventos de pedido da Nuvem Shop não têm variável de cupom para usar nas mensagens. As fotos dos produtos são gravadas como links para as imagens da própria Nuvem Shop. Textos cadastrados em mais de um idioma são gravados no idioma principal da loja. Um produto removido na loja (pelo evento Produto removido ou pelo Executar agora de Produtos) sai da lista de Produtos do E-commerce, mas continua nos pedidos antigos. Um produto oculto na loja é gravado normalmente, mas o assistente do Chatbot do site não o oferece.

​

OctaTag e Conteúdo Rico na vitrine

Ao conectar a loja, Instalar OctaTag na loja e Inserir o Conteúdo Rico nas páginas de produto já nascem ligados. Você não cola código no tema: a Nuvem Shop carrega a OctaTag na vitrine por conta própria, e os widgets da OctaSend, como o Conteúdo Rico, passam a aparecer. Para desligar, use os interruptores da aba Conexão. Como o Conteúdo Rico funciona na página de produto:

• Aparece só em páginas de produto, e o conteúdo é buscado pelo SKU: produto sem SKU não mostra conteúdo.
• Entra na primeira posição que existir, nesta ordem: logo depois do Seletor CSS (opcional) que você configurou; logo antes dos produtos similares; logo depois da descrição do produto; no fim do <main>. Se nenhuma existir, nada é inserido.
• Se você já colou à mão um bloco <div data-octasend-content> no tema, a OctaSend não insere outro.
• Antes dos produtos similares e no fim do <main>, o conteúdo entra dentro de um contêiner com a classe container do tema, para ter a largura dos demais blocos. Depois da descrição ou do seu seletor, ele entra solto e herda a largura do ponto onde cai.
• Se você usa a lista de domínios autorizados do embed, inclua o endereço da loja.

​

Automações

Os eventos e pedidos da loja também iniciam automações, de forma independente do mapeamento:

• Gatilho Evento de uma loja: cada evento recebido inicia as automações daquele evento, desde que traga e-mail ou telefone do cliente. Os eventos de produto não aparecem nesse gatilho, porque não têm destinatário.
• Gatilho Chegou um pedido: os pedidos que chegam por evento e os encontrados na conferência diária de pedidos disparam essas automações. Na Nuvem Shop, a situação do pedido considerada é cancelado quando o pedido foi cancelado e, nos outros casos, o status do pagamento. A situação enviado considera o status do envio, e um pedido cancelado nunca a dispara.
• Passo Aguardar evento: libera a execução quando chega o evento esperado do mesmo cliente da execução, comparando o e-mail ou o telefone. Um evento de outro cliente não libera a espera. Os eventos de produto valem para a loja inteira.

As automações não dependem do mapeamento:

• Uma automação com o gatilho Evento de uma loja, ou com o passo Aguardar evento, da Nuvem Shop funciona mesmo sem comunicação escolhida para aquele evento no mapeamento. Os eventos de pedido, cliente e produto já chegam sempre; para Pedido aguardando pagamento, ao publicar ou reativar a automação, a OctaSend pede à loja para enviar esse evento.
• Se a loja recusar o pedido, o painel avisa que a automação está ativa, mas a loja não confirmou o envio do evento. Publique de novo para tentar outra vez. Os eventos que a loja já enviava continuam chegando.
• Quando um aviso da loja se perde, a conferência diária de pedidos recupera os eventos Pedido criado, Pedido pago e Pedido cancelado que estão em uso no mapeamento ou numa automação ativa, se a mudança aconteceu depois da conexão e a Nuvem Shop informa quando ela aconteceu. A regra “mensagem que já saiu não sai de novo” impede envio repetido.
• Se o evento também tiver comunicação no mapeamento, o cliente recebe a comunicação do mapeamento e a da automação.

​

Pedidos de dados e remoção (LGPD)

A Nuvem Shop repassa à OctaSend os pedidos de privacidade dos seus clientes:

• Pedido de dados de um cliente: a tela Eventos da Nuvem Shop (aberta por Configurar eventos, com a integração Conectado) mostra o aviso “A loja pediu os dados do cliente”, com o identificador do cliente e o botão Baixar dados, que entrega um arquivo JSON com o que a OctaSend guarda desse cliente (cadastro e pedidos). Depois do download, o aviso some.
• Remoção de um cliente: o cadastro do cliente sai da OctaSend e os pedidos dele ficam sem nome, e-mail, telefone, documento e endereço; valores, datas, itens e status continuam, para as métricas. Se a OctaSend tinha esse cliente ou pedidos dele, também apaga de Contatos os contatos da sua conta com o mesmo e-mail (quando a loja não informa e-mail, os contatos sem e-mail com o mesmo telefone), venham eles da loja ou não. Ficam os contatos que conversaram com você no WhatsApp (inclusive em grupo) ou com o assistente do Chatbot do site.
• Remoção da loja (a Nuvem Shop pede depois que o app é desinstalado): clientes, pedidos e produtos da loja saem da OctaSend. O mapeamento de eventos fica, para quando você conectar de novo. Se a loja não estiver desinstalada, nada é apagado.

​

Desconectar e reconectar

• Desconectar, no card da integração, age na hora, sem pedir confirmação. A OctaSend remove da loja os avisos de eventos, apaga o acesso guardado e a integração passa a Desconectado: param os eventos, a conferência de pedidos e a conferência dos avisos. O app continua instalado na sua loja Nuvem Shop.
• O mapeamento, as rotinas e os dados já sincronizados no E-commerce são mantidos.
• Se o app for desinstalado na Nuvem Shop, a integração passa a Desconectado automaticamente, o acesso guardado é apagado e os disparos param. O card mostra “A app foi desinstalada na loja. Para voltar a receber eventos, conecte de novo.”
• Se a loja suspender o app, a integração fica Com erro com o motivo “A loja suspendeu a app. Reative na Nuvem Shop.”. Quando o app é reativado, ela volta a Conectado sozinha.
• Se a Nuvem Shop recusar o token de acesso, a integração fica Com erro com o motivo “Token de acesso invalido ou expirado — reconecte a loja.”
• Para reconectar, clique em Conectar no card (com a integração Conectado, clique antes em Desconectar), autorize de novo e confirme em Confirmar conexão da loja. Instalar o app de novo pela loja de aplicativos da Nuvem Shop leva à mesma confirmação. O mapeamento e as rotinas que você já tinha continuam valendo, os avisos dos eventos são registrados de novo na loja e a importação do catálogo roda outra vez.
• Se a conexão der certo mas o registro dos avisos na loja falhar, o card mostra o aviso “Conectado, mas falhou ao registrar os webhooks. Salve o mapeamento novamente.” Abra Configurar eventos e clique em Salvar no mapeamento para tentar de novo; a conferência diária dos avisos também tenta sozinha. Quando o registro dá certo, o aviso some do card.

​

Veja também