> ## 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. # Conta Azul > Conecte sua empresa da Conta Azul para enviar mensagens a cada evento financeiro e sincronizar clientes, produtos e vendas com o E-commerce A integração com a **Conta Azul** conecta o seu ERP financeiro à OctaSend. Com ela você: * **Envia mensagens automáticas** a cada evento financeiro: conta a receber criada, vencimento próximo, conta vencida, pagamento recebido e venda criada, pelos canais que você já usa (WhatsApp, e-mail, SMS). * **Sincroniza clientes, produtos e vendas** com o menu [E-commerce](https://docs.octasend.com.br/plataforma/ecommerce.md), mesmo que você não tenha loja virtual. * **Alimenta as [automações](https://docs.octasend.com.br/plataforma/automacoes.md)** com os eventos da Conta Azul e com as vendas novas. ## Conectar **1. Inicie a conexão** Na OctaSend, abra **Configurações → Desenvolvedores → Integrações**, clique em **Conectar** no card da Conta Azul e, na tela seguinte, em **Conectar com Conta Azul**. **2. Autorize na Conta Azul** Entre com seu login da Conta Azul e autorize o acesso. **3. Confirme** De volta à OctaSend, confira a empresa na tela **Confirmar conexão** e clique em **Conectar**. A OctaSend só lê as contas a receber, as vendas e o contato dos clientes (celular, telefone e e-mail), além dos produtos e do cadastro dos clientes para o E-commerce: não cria, não altera e não apaga nada na Conta Azul. * Cada conta OctaSend conecta **uma empresa** Conta Azul. * Existe um ambiente só: não há sandbox. Para testar, use uma conta de teste do ERP. * Não há webhook. A OctaSend consulta a Conta Azul **a cada 15 minutos** para conta criada, pagamento recebido e venda criada, por isso a mensagem pode chegar cerca de 15 minutos depois do fato. **Vencimento próximo** e **Conta a receber vencida** são conferidos de hora em hora, a partir das 08:00 ([veja abaixo](#lembrete-de-vencimento)). ## Mapear os eventos Em **Configurações → Desenvolvedores → Integrações**, clique em **Configurar eventos** no card da Conta Azul. Na aba **Mapeamento de eventos**, escolha uma comunicação para cada evento e clique em **Salvar**. Evento sem comunicação (**Não enviar nada**) não dispara nada. | Evento | Quando acontece | Envia uma vez? | | - | - | - | | **Conta a receber criada** | Uma conta a receber nova aparece na Conta Azul | Sim, por parcela (uma venda parcelada gera um evento por parcela) | | **Vencimento próximo** | Faltam N dias para vencer ([veja abaixo](#lembrete-de-vencimento)) | Sim, por parcela e data de vencimento | | **Conta a receber vencida** | A parcela venceu nos últimos 3 dias e segue em atraso ([veja abaixo](#lembrete-de-vencimento)) | Sim, por parcela e data de vencimento | | **Pagamento recebido** | Uma parcela é quitada por completo (pagamento parcial não dispara) | Sim, por parcela | | **Venda criada** | Uma venda nova aparece na Conta Azul (orçamento, venda esperando aprovação, cancelada, recusada ou rascunho não dispara) | Sim, por venda | > [!NOTE] > > Nada que já existia antes da conexão dispara mensagem: conta criada, pagamento recebido e venda criada só valem para o que acontece depois de conectar. Se a parcela for paga entre a busca e o envio, **Vencimento próximo** e **Conta a receber vencida** não saem e aparecem no histórico como **Ignorado**, com o motivo. ## Variáveis O painel lateral da tela de eventos mostra as variáveis do evento selecionado, com botão para copiar. **Eventos de conta a receber** (criada, vencimento próximo, vencida e pagamento recebido) | Variável | O que traz | | - | - | | `{{cliente_nome}}` | Nome do cliente | | `{{cobranca_valor}}` | Valor da conta, já com R$ (por exemplo, R$ 1.234,56) | | `{{cobranca_vencimento}}` | Vencimento (dd/mm/aaaa) | | `{{cobranca_descricao}}` | Descrição da conta a receber | | `{{cobranca_referencia}}` | Identificador da parcela na Conta Azul | **Venda criada** | Variável | O que traz | | - | - | | `{{cliente_nome}}` | Nome do cliente | | `{{venda_numero}}` | Número da venda | | `{{venda_total}}` | Valor total da venda, já com R\$ | | `{{venda_data}}` | Data da venda (dd/mm/aaaa) | Variável que não existe no evento não é substituída: a mensagem chega com o texto `{{nome_da_variavel}}`. ### Quem recebe a mensagem A mensagem vai para o celular do cadastro da pessoa na Conta Azul (ou o telefone, se não houver celular) e para o e-mail dela (o primeiro válido, se o cadastro tiver mais de um). Quem está sem contato no cadastro, ou conta sem cliente informado, aparece no histórico como **Ignorado**, com o motivo. ## Lembrete de vencimento A Conta Azul não avisa "vai vencer", então a OctaSend procura sozinha, **de hora em hora**, as parcelas em aberto que vencem daqui a **N dias** e dispara o evento **Vencimento próximo** para cada uma, sem repetir para a mesma parcela e data de vencimento. A mesma rotina procura as parcelas que venceram nos últimos 3 dias e seguem em atraso, para o evento **Conta a receber vencida**. Ela só consulta a Conta Azul para os eventos que têm comunicação mapeada ou são usados numa automação ativa. > [!NOTE] > > O lembrete só envia **a partir das 08:00 (horário de Brasília)**, para a mensagem não chegar de madrugada. Antes disso, o **Executar agora** também não envia nada. Configure em **Configurar eventos → aba Rotinas → Lembrete de vencimento**: | Campo | O que faz | | - | - | | **Ativo** | Liga ou desliga a rotina. Desligada, nem **Vencimento próximo** nem **Conta a receber vencida** são enviados | | **Avisar quantos dias antes do vencimento** | De 0 a 30 (padrão 3). Vale só para **Vencimento próximo** | | **Salvar alterações** | Grava a configuração | | **Executar agora** | Roda a busca na hora, sem esperar a próxima rodada | ## Clientes, produtos e pedidos Ao conectar, a Conta Azul libera o módulo **E-commerce** da OctaSend, mesmo que você não tenha loja virtual. Clientes, produtos e vendas aparecem em **E-commerce → Clientes, Produtos e Pedidos**, com **Conta Azul** como origem, e entram no dashboard e nos gráficos. | Na Conta Azul | Na OctaSend | | - | - | | Pessoas com perfil **Cliente** (fornecedores ficam de fora) | Clientes, com nome, e-mail, telefone e CPF/CNPJ. Endereço e celular entram para quem tem venda importada | | **Produtos** | Produtos, com nome, código (SKU), preço de venda, estoque e ativo/inativo. Sem variações, imagens nem descrição | | **Vendas** aprovadas e canceladas dos últimos **12 meses** | Pedidos, com número, total, data de criação, cliente e itens. O status é a descrição da situação na Conta Azul (por exemplo, "Aprovado"); venda cancelada entra como cancelada | Orçamentos, vendas esperando aprovação, recusadas e rascunhos não entram. Serviços não entram no catálogo de produtos: aparecem só como itens do pedido. ### Importação em fatias Logo depois de conectar, a OctaSend importa o histórico aos poucos, sem disputar o limite da API com as mensagens. Em **Configurar eventos → aba Rotinas**, a seção **Clientes, produtos e pedidos** mostra cada rotina com o intervalo fixo (**A cada N minutos**) e o progresso: | Estado | O que significa | | - | - | | **Importando…** | Mostra quantos registros já foram importados e, nos pedidos, quanto do histórico de 12 meses já foi percorrido. Enquanto importa, **Executar agora** fica desabilitado: a importação já roda sozinha. Antes de a primeira fatia rodar, aparece **Importação na fila** | | **Atualizado…** | Mostra a última busca (por exemplo, "Atualizado há 5 minutos") | | **Falhou** | Mostra o motivo. Durante a importação, a OctaSend tenta de novo sozinha; depois dela, **Executar agora** tenta de novo na hora | | **Pausada** | A integração pede reconexão: nada roda até você reconectar | ### Atualização contínua Terminada a importação, a OctaSend busca só o que mudou: pedidos a cada **15 minutos**, clientes e produtos a cada **60 minutos**. Os intervalos são fixos. **Executar agora** antecipa a próxima busca, por exemplo para reparar algo que mudou na Conta Azul. > [!WARNING] > > A busca do que mudou olha no máximo **60 dias** para trás. Se a integração ficar desconectada por mais de 60 dias, vendas, clientes e produtos criados ou alterados antes desse limite não voltam sozinhos ao reconectar, e **Executar agora** usa o mesmo limite. Conectar outra empresa da Conta Azul recomeça a importação do zero. ### Automações e mensagens Só venda **nova** (criada depois da conexão) dispara o gatilho **Chegou um pedido** e a mensagem de **Venda criada**. O histórico importado não dispara nenhum dos dois, e mudar o status de uma venda depois atualiza o pedido no E-commerce sem disparar nada. No gatilho, use **Origem do pedido** para escolher a Conta Azul quando a mesma venda também chegar por outra integração. > [!WARNING] > > **Atenção aos segmentos.** Os pedidos importados, inclusive os antigos, contam para os segmentos de contatos por compra (pedidos, valor gasto, dias desde a última compra). Contatos que já existiam e casam com clientes da Conta Azul podem passar a entrar em segmentos por compras do histórico, e [automações](https://docs.octasend.com.br/plataforma/automacoes.md) e campanhas por segmento podem alcançar esses contatos. Revise as automações e as campanhas por segmento **antes de conectar**. ## Acompanhar As abas **Eventos recebidos** e **Logs** mostram cada evento com o resultado: | Resultado | Quando | | - | - | | **Recebido** | O evento chegou e ainda está sendo processado | | **Enviado** | A mensagem foi aceita para envio | | **Ignorado** | Sem comunicação mapeada, sem destinatário, conta que já foi paga ou já enviado | | **Falhou** | Houve erro; o motivo aparece junto | As rotinas de clientes, produtos e pedidos também aparecem em **Logs**. ## Reconectar e desconectar * Se o acesso for revogado, os eventos passam a falhar e o card mostra o erro. Clique em **Reconectar** (no card ou na faixa de erro da tela de eventos) e autorize de novo. * **Desconectar** remove as credenciais na OctaSend. Para revogar o acesso também do lado da Conta Azul, faça isso no portal da Conta Azul. ## Limitações * Uma empresa Conta Azul por conta OctaSend, em um ambiente só (sem sandbox). * Atraso de até cerca de 15 minutos entre o fato e a mensagem (de até 1 hora para **Vencimento próximo** e **Conta a receber vencida**), e de cerca de 15 minutos entre a venda e o pedido no E-commerce. * As mensagens não trazem link de boleto nem Pix. * Contas a pagar, notas fiscais, fornecedores e movimentação de estoque não fazem parte desta integração. * Parcelas vencidas há mais de 3 dias não recebem o aviso de vencida. * No E-commerce: vendas de até 12 meses antes da conexão; sem variações, imagens nem descrição de produto; serviços só como itens de pedido; condição de pagamento e rastreio não entram. ## Veja também > [card] [Integrações](https://docs.octasend.com.br/integracoes/visao-geral.md) > > As plataformas disponíveis e o que muda entre elas > [card] [Asaas](https://docs.octasend.com.br/integracoes/asaas.md) > > Mensagens de cobrança a partir do Asaas > [card] [E-commerce](https://docs.octasend.com.br/plataforma/ecommerce.md) > > Clientes, pedidos e produtos sincronizados > [card] [Automações](https://docs.octasend.com.br/plataforma/automacoes.md) > > Sequências de mensagens a partir de eventos e vendas This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.