> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrações

> Conecte sua loja virtual à OctaSend para disparar comunicações pelos eventos da loja e sincronizar clientes, produtos e pedidos

As **integrações** ligam a sua loja virtual, o seu ERP ou o seu sistema de cobrança à OctaSend. Depois de conectada, a plataforma passa a:

* **disparar comunicações sozinha** a partir dos próprios eventos (pedido pago, pedido enviado, mudança de situação e outros), sem nenhuma chamada de API;
* **sincronizar clientes, produtos e pedidos** com o menu [E-commerce](https://docs.octasend.com.br/plataforma/ecommerce.md);
* **iniciar [automações](https://docs.octasend.com.br/plataforma/automacoes.md)** a partir de eventos da loja e da chegada de pedidos.

## Onde fica

No menu lateral, abra **Configurações → Integrações**. Cada plataforma disponível aparece num card com o status da conexão, o nome da loja, a data do **Último evento** recebido e o motivo, quando houver erro.

| Status | O que significa |
| - | - |
| **Não conectado** | A loja ainda não foi conectada, ou a conexão foi iniciada e não chegou ao fim. |
| **Conectado** | A integração está funcionando. O card mostra **Configurar eventos** e **Desconectar** e, nas conexões por token (Wake), também **Editar conexão**. |
| **Com erro** | A OctaSend não consegue usar a loja (autorização falhou, token recusado ou app suspenso). O motivo aparece no card. |
| **Desconectado** | Você desconectou a loja, ou o app foi desinstalado na plataforma. |

Cada conta conecta **uma loja (ou empresa) por plataforma**. 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ê os cards e a tela de eventos, sem os botões que mudam alguma coisa.

## Plataformas disponíveis

> [card] [Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md)
>
> Conexão em um clique, eventos de pedido, cliente e produto

> [card] [Wake Commerce](https://docs.octasend.com.br/integracoes/wake.md)
>
> Conexão por token, situações de pedido, rastreio e carrinho abandonado

> [card] [Shopify](https://docs.octasend.com.br/integracoes/shopify.md)
>
> Eventos de pedido, checkout abandonado e OctaTag por incorporação do app

> [card] [Yampi](https://docs.octasend.com.br/integracoes/yampi.md)
>
> Pedidos, pagamento recusado, nota fiscal, carrinho abandonado e OctaTag na vitrine

> [card] [Tray](https://docs.octasend.com.br/integracoes/tray.md)
>
> Conexão pela loja, carrinho abandonado detectado pela OctaSend e rotinas com Executar agora

> [card] [Olist Ecommerce](https://docs.octasend.com.br/integracoes/olist.md)
>
> Pedido, cliente novo e carrinho abandonado por token, com Conteúdo Rico na vitrine

> [card] [Linx Commerce](https://docs.octasend.com.br/integracoes/linx.md)
>
> Fila de integração da Linx, importação retomável e Conteúdo Rico na vitrine

### ERPs e sistemas financeiros

Estas integrações não são lojas virtuais: elas trazem pedidos de venda, cobranças e contas a receber para disparar mensagens e alimentar o E-commerce e as automações.

> [card] [Bling](https://docs.octasend.com.br/integracoes/bling.md)
>
> Pedidos por situação, rastreio e nota fiscal autorizada, com contatos, produtos e estoque

> [card] [Conta Azul](https://docs.octasend.com.br/integracoes/conta-azul.md)
>
> Contas a receber e vendas, com clientes, produtos e vendas no E-commerce

> [card] [Asaas](https://docs.octasend.com.br/integracoes/asaas.md)
>
> Cobrança criada, vencida e paga, e lembrete antes do vencimento

A Nuvem Shop e a Wake têm a tabela comparativa logo abaixo. As demais plataformas seguem o mesmo modelo de mapeamento de eventos, e cada página descreve o que é próprio dela: como conecta, quais eventos chegam, as variáveis, o que é importado e as rotinas.

Algumas integrações são liberadas aos poucos, conta por conta (por exemplo, o botão de conexão por OAuth da Yampi e a Tray). Se o card de uma plataforma não aparecer em **Configurações → Integrações**, fale com a OctaSend.

| | Nuvem Shop | Wake Commerce |
| - | - | - |
| **Como conecta** | Você autoriza o acesso na própria Nuvem Shop | Você cola o token da API da Wake na tela |
| **Eventos** | Pedido (criado, pago, aguardando pagamento, embalado, enviado, cancelado, atualizado), cliente e produto | Pedido novo, cada situação de pedido da sua loja e atualização de rastreio |
| **Quais eventos chegam** | Todos os de pedido, cliente e produto, desde a conexão (**Pedido aguardando pagamento** só quando está em uso no mapeamento ou numa automação ativa) | Todos os de pedido, desde a conexão |
| **Quando o evento é processado** | Na hora | Normalmente em até um minuto |
| **Carrinho abandonado** | Não | Sim, com o token da Storefront API e o script (ou a tag da OctaSend) no site |
| **Importação na conexão** | Clientes, produtos e pedidos | Pedidos dos últimos 12 meses, com clientes e produtos tirados dos pedidos |
| **Rotinas de sincronização** | Clientes, Produtos e Pedidos, só pelo **Executar agora** (os dados chegam pelos avisos da loja) | Produtos e Pedidos, no intervalo que você define e pelo **Executar agora** |

## Como funciona

**1. Conecte a loja**

Em **Configurações → Integrações**, clique em **Conectar** no card da plataforma e siga os passos da página dela. Ao conectar, a OctaSend importa os dados da loja em segundo plano e cria as rotinas de sincronização.

**2. Mapeie os eventos**

Clique em **Configurar eventos**. Na aba **Mapeamento de eventos**, escolha qual comunicação sai em cada evento da loja e clique em **Salvar**. Use as **Variáveis disponíveis** de cada evento no texto da comunicação.

**3. Acompanhe**

Veja o que chegou da loja e o que aconteceu com cada evento na aba **Eventos recebidos**, e o histórico das rotinas e dos eventos na aba **Logs**. O resultado de cada envio fica em [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md).

A tela de eventos da integração tem quatro abas:

| Aba | O que faz |
| - | - |
| **Mapeamento de eventos** | Escolhe a comunicação de cada evento da loja e mostra as variáveis do evento selecionado. |
| **Rotinas** | Na Wake, define de quanto em quanto tempo a OctaSend consulta a loja para atualizar produtos e pedidos. Na Nuvem Shop, as rotinas não rodam sozinhas, porque os dados chegam pelos avisos da loja. Nas duas, **Executar agora** roda uma rotina na hora. |
| **Logs** | Junta as execuções das rotinas e os eventos recebidos num só histórico. |
| **Eventos recebidos** | Os eventos mais recentes da loja com o status: **Recebido**, **Enviado**, **Ignorado** ou **Falhou**. |

## Mapeamento ou automação

Um evento da loja pode gerar mensagem de dois jeitos, e os dois funcionam de forma independente:

* **Mapeamento de eventos da integração:** uma comunicação por evento, enviada na hora, sem passos.
* **[Automações](https://docs.octasend.com.br/plataforma/automacoes.md):** sequências com esperas, condições e vários envios, a partir dos gatilhos **Evento de uma loja** ou **Chegou um pedido**.

Se um evento tiver comunicação mapeada e também uma automação, as duas saem. Uma automação não precisa de comunicação no mapeamento para receber o evento: ao publicá-la, a OctaSend pede à loja para enviar os eventos que ela usa.

> [!NOTE]
>
> As integrações não precisam de código. Se você prefere disparar as mensagens pelo seu próprio sistema, use a [API de envio](https://docs.octasend.com.br/api-reference/enviar-mensagens.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.