Integrações

Visão Geral

As integrações da Paralela conectam a sua operação com outros sistemas e ferramentas que você já utiliza. Com as integrações, informações fluem automaticamente entre plataformas, eliminando trabalho manual e garantindo que seus processos estejam sempre atualizados.

As principais formas de integração são:

Tipo	O que faz
Webhooks de saída	A Paralela avisa um sistema externo quando algo acontece
Webhooks de entrada	Um sistema externo envia dados para a Paralela
API de Mensagens	Você envia mensagens e gerencia conversas pela Paralela a partir de outro sistema
Servidor MCP (IA)	Agentes de IA externos (ex.: Claude Desktop) operam a plataforma em seu nome
Conectar seu sistema de gestão	Você conecta o seu ERP na tela de configurações e a Paralela sincroniza os produtos nos dois sentidos, reconhece os seus clientes e pode lembrar de boletos em aberto
Sincronização com sistema próprio	Seu ERP ou sistema de gestão envia produtos e contatos para a Paralela
Fila de saída	Pedidos e agendamentos criados na Paralela seguem para o seu sistema de gestão

Além disso, a plataforma oferece integração com o serviço de vozes ElevenLabs para respostas em áudio dos assistentes de IA.

---

Webhooks de Saída

O que são

Um webhook de saída funciona como uma notificação automática. Toda vez que algo relevante acontece na Paralela (uma nova conversa, uma mensagem recebida, etc.), a plataforma envia essa informação para um endereço que você configurar. Pense nisso como um aviso: "algo aconteceu, aqui estão os detalhes".

Passo a passo

1. Acessar a página de Webhooks

Abra API & Webhooks no menu lateral: ele leva à aba Gatilhos da tela Automações, no tipo Webhooks e eventos. Se o item não aparece, abra Configurações Avançadas e, em Itens Ocultos do Menu, clique em API & Webhooks para mostrá-lo no menu (ou procure "Webhooks" na lupa do topo). Você verá a lista de todos os webhooks configurados na sua conta, tanto de saída quanto de entrada.

2. Criar um novo webhook de saída

1. Clique no botão Adicionar no canto superior da página.
2. Na janela que abrir, preencha os campos de configuração conforme a tabela abaixo.
3. Clique em Salvar.

3. Preencher os campos de configuração

Campo	Descrição	Exemplo
Nome	Identificação interna do webhook	"Sync CRM Vendas"
URL de destino	Endereço completo (incluindo https://) para onde a Paralela enviará os dados	https://meucrm.com/api/webhook
Método HTTP	Tipo de requisição HTTP utilizada no envio	POST, GET, PUT, DELETE
Ação	Define o comportamento: chamar o webhook externo ou disparar um fluxo interno	Webhook ou Fluxo
Autenticação HMAC	Chave secreta opcional. A Paralela assina cada requisição com essa chave, permitindo ao sistema receptor validar que os dados são autênticos	Qualquer string secreta

Sobre a ação "Fluxo": quando selecionada, em vez de enviar dados para uma URL externa, o evento dispara um fluxo de automação dentro da Paralela. Útil para criar automações internas sem precisar de um sistema externo.

Sobre autenticação HMAC: o sistema receptor pode usar a chave secreta para verificar a assinatura da requisição e confirmar que os dados vieram da Paralela, não de um terceiro.

4. Selecionar os eventos

Marque quais eventos devem disparar o webhook. Cada evento envia um payload JSON com os dados relevantes.

Evento	Quando dispara	Dados incluídos
Nova conversa	Um ticket é criado	ID do ticket, contato, fila, canal
Nova mensagem	Uma mensagem é recebida	Conteúdo da mensagem, contato, ticket
Novo contato	Um contato é criado	Nome, número, dados do contato
Novo cliente no sistema integrado	Um contato aparece pela primeira vez no sistema de gestão conectado (por exemplo, quando vira associado). Veja Boas-vindas ao novo cliente do sistema	Contato e sistema de onde veio. Disponível só em fluxos
Ticket transferido	Um ticket é transferido para outro atendente	Ticket, atendente/fila de origem e destino
Fila do ticket alterada	Um ticket muda de fila	Ticket, fila anterior e nova
Tag adicionada / Tag removida	Uma tag é adicionada ou removida do ticket	Ticket, tag
Etapa do kanban alterada	O ticket muda de etapa no kanban	Ticket, etapa anterior e nova, kanban
Removido do kanban	O ticket sai do kanban	Ticket, etapa/tag
Campo personalizado alterado	Um campo personalizado do ticket muda	Ticket, campo, valor anterior e novo
Novo pedido	Um pedido é criado	Dados do pedido
Pagamento recebido	O pagamento de um pedido é confirmado	Pedido, valor, meio de pagamento
Status de entrega alterado	O fulfillment de um pedido muda	Pedido, status anterior e novo
Novo agendamento / Mudança de agendamento	Um agendamento é criado ou alterado	Dados do agendamento
Status da conexão	Uma conexão WhatsApp muda de status	Canal, status atual
Status da fatura	Uma fatura muda de status	Dados da fatura
Campanha de email	Evento de campanha de email	Dados da campanha
Sem resposta do atendente	Atendente não respondeu dentro do prazo	Ticket, tempo de espera
Prospecção: comportamento do contato	Um contato de uma prospecção não respondeu, respondeu, mostrou interesse, fechou ou não fechou, depois dos dias de espera escolhidos (0 a 90)	Contato, nome da prospecção (prospection_name) e comportamento (prospection_behavior). Veja Prospecção — comportamento do contato

Gatilhos de agendamento e de contato: a conexão

Ao configurar um gatilho de agendamento (novo agendamento, mudança de agendamento, lembretes) ou de novo contato num fluxo, a conexão selecionada define por qual conexão o fluxo será executado (por exemplo, de qual número as notificações serão enviadas). Ela não restringe quais eventos disparam o fluxo: um agendamento ou contato não pertence a uma conexão específica, então o gatilho dispara para qualquer agendamento/contato criado na empresa — inclusive os que a I.A. cria durante conversas em outras conexões.

5. Testar o webhook

1. Após salvar, localize o webhook na lista.
2. Clique no botão de teste (ícone de envio) na coluna de ações.
3. A Paralela envia uma requisição de exemplo para a URL configurada com dados fictícios.
4. Verifique no sistema receptor se os dados chegaram corretamente.

Se o teste falhar, confira:

• A URL está acessível pela internet (não pode ser localhost).
• O método HTTP está correto.
• O sistema receptor aceita requisições da Paralela (verifique firewalls e CORS).

6. Verificar logs de requisição

1. Clique no webhook desejado para abrir os detalhes.
2. Consulte o histórico de envios nos logs de requisição.
3. Cada log mostra: data/hora, status HTTP retornado, corpo da resposta.

Use os logs para identificar falhas (status 4xx ou 5xx) e depurar problemas de integração.

Casos de uso

Cenário	Como configurar
Sincronizar contatos com CRM	Crie um webhook de saída com evento "Novo contato" apontando para a API do seu CRM
Registrar conversas em planilha	Use evento "Nova conversa" com URL de um serviço como Google Sheets (via Apps Script ou Zapier)
Notificar equipe no Slack	Configure evento "Nova mensagem" apontando para um webhook de entrada do Slack
Atualizar ERP com pedidos	Use evento "Novo pedido" apontando para a API do seu ERP
Alerta de atendente ausente	Configure "Sem resposta do atendente" para notificar um canal de supervisão

---

Webhooks de Entrada

O que são

Um webhook de entrada funciona no sentido oposto: um sistema externo envia dados para a Paralela. A plataforma gera uma URL única que você configura no outro sistema como destino. Quando esse sistema envia informações para a URL, a Paralela recebe e processa os dados.

Passo a passo

1. Criar um webhook de entrada

1. Abra API & Webhooks no menu lateral (aba Gatilhos da tela Automações, tipo Webhooks e eventos). Se o item não aparece, abra Configurações Avançadas e, em Itens Ocultos do Menu, clique em API & Webhooks para mostrá-lo no menu (ou procure "Webhooks" na lupa do topo).
2. Clique no botão Novo webhook.
3. Selecione o tipo Entrada.
4. Preencha o nome de identificação do webhook.
5. Clique em Salvar.

A Paralela gera automaticamente uma URL única e um token de autenticação para este webhook.

2. Copiar a URL única

1. Após criar, localize o webhook de entrada na lista.
2. Clique no botão de copiar ao lado da URL.
3. A URL segue o formato: https://api.suaempresa.com/webhook/incoming/{token} (o endereço exato do seu servidor já vem na URL copiada)

Essa URL é exclusiva deste webhook. Qualquer requisição enviada para ela será processada pela Paralela.

3. Configurar a URL no sistema externo

No sistema que vai enviar dados para a Paralela:

1. Localize a seção de webhooks, notificações ou integrações.
2. Cole a URL copiada como destino.
3. Configure o formato de envio como JSON.
4. Ative o webhook no sistema externo.

4. Configurar segurança

Opção	Descrição	Quando usar
Token de autenticação	Token único gerado automaticamente. O sistema externo deve inclui-lo na URL para validar a origem da requisição	Sempre ativo por padrão. A URL já contém o token
Validação HMAC	Chave secreta compartilhada. O sistema externo assina o payload com essa chave, e a Paralela verifica a assinatura	Quando o sistema externo suporta HMAC e você precisa de segurança adicional

Como funciona a validação HMAC:

1. Defina uma chave secreta no campo de HMAC do webhook de entrada.
2. Configure a mesma chave no sistema externo.
3. O sistema externo assina cada requisição usando a chave.
4. A Paralela verifica a assinatura antes de processar os dados.

5. Métodos HTTP aceitos

Método	Uso típico
GET	Consultas simples, dados via query string
POST	Envio de dados no corpo da requisição (mais comum)
PUT	Atualização de dados
DELETE	Sinalização de remoção

Por padrão, apenas o método POST é aceito. Você pode habilitar métodos adicionais na configuração do webhook.

6. Limite de requisições

O webhook de entrada aceita até 100 requisições por minuto por IP. Requisições que excedam esse limite recebem resposta HTTP 429 (Too Many Requests).

Se você espera volume maior, entre em contato com o suporte para avaliar alternativas.

7. Configurar ações ao receber dados

Quando a Paralela recebe dados em um webhook de entrada, você pode configurar o que acontece:

Ação	Descrição	Quando usar
Disparar um fluxo	Inicia um fluxo de automação usando os dados recebidos como variáveis	Processar pagamentos, criar tickets, enviar mensagens automáticas
Disparar um webhook de saída	Encaminha os dados recebidos para outro sistema externo	Rotear dados entre sistemas, criar pipelines de integração

Disparar um fluxo é a opção mais comum. Os dados recebidos ficam disponíveis como variáveis dentro do fluxo, permitindo automações como:

• Enviar uma mensagem de confirmação ao contato.
• Criar ou atualizar um ticket.
• Registrar informações em campos personalizados.

Identificação do contato: você pode configurar qual campo da requisição contém o identificador do contato (telefone, email ou ID do contato). Isso permite que o fluxo disparado saiba para quem enviar mensagens.

Tipo de identificação	Campo esperado	Exemplo
Telefone	Número com DDI	5511999998888
Email	Endereço de email	cliente@email.com
ID do contato	ID interno da Paralela	12345

8. Verificar o log da última requisição

1. Na lista de webhooks, localize o webhook de entrada.
2. Clique para abrir os detalhes.
3. A seção Última requisição mostra:

Informação	Descrição
Data/hora	Quando a requisição foi recebida
Método HTTP	GET, POST, PUT ou DELETE
Headers	Cabeçalhos enviados pelo sistema externo
Body	Corpo da requisição (dados recebidos)
IP de origem	Endereço IP do sistema que enviou a requisição
Status	Código de resposta retornado

Use esse log para confirmar que os dados estão chegando no formato esperado e identificar problemas.

Modo de teste: webhooks de entrada possuem um modo de teste que permite receber requisições e registrar os dados sem executar nenhuma ação. Útil para validar o formato dos dados antes de conectar a um fluxo.

Exemplo prático: recebendo notificações de pagamento

Cenário: uma plataforma de e-commerce envia uma notificação quando um pagamento é confirmado. A Paralela recebe essa notificação e envia uma mensagem de confirmação ao cliente.

Configuração:

1. Crie um webhook de entrada na Paralela chamado "Pagamentos E-commerce".
2. Copie a URL gerada.
3. No painel do e-commerce, configure a URL como destino de notificações de pagamento.
4. Na Paralela, configure o campo de identificação do contato como "telefone" e indique qual campo do payload contém o número (ex: customer_phone).
5. Crie um fluxo de automação que:
   • Recebe os dados do pagamento.
   • Envia uma mensagem ao cliente: "Seu pagamento de R$ {valor} foi confirmado! Pedido #{numero_pedido}".
6. Associe esse fluxo ao webhook de entrada.

Payload esperado do e-commerce:

{
  "event": "payment_confirmed",
  "order_id": "12345",
  "amount": 199.90,
  "customer_phone": "5511999998888",
  "customer_name": "Maria Silva"
}

Resultado: toda vez que um pagamento for confirmado, o cliente recebe automaticamente uma mensagem no WhatsApp com os detalhes.

---

API de Mensagens

O que é

A API de Mensagens permite que sistemas externos enviem mensagens, gerenciem contatos e controlem conversas pela Paralela de forma programática. Com ela, você integra o envio de mensagens ao seu CRM, ERP ou qualquer outro sistema.

Passo a passo

1. Acessar a página de API

Abra API de Mensagens no menu lateral. Se o item não aparece, abra Configurações Avançadas e, em Itens Ocultos do Menu, clique em API de Mensagens para mostrá-lo no menu (ou procure "API de Mensagens" na lupa do topo). A página está dividida em seções: Começando, Mensagens, Contatos, Atendimentos, Listas de apoio e Servidor MCP (IA).

2. Escolher a conexão e obter o token

Cada conexão de WhatsApp tem seu próprio token de API. No topo da página, o seletor Conexão usada nos exemplos define qual conexão a integração vai usar:

1. Escolha a conexão no seletor.
2. Clique no ícone de olho para revelar o token e no ícone de cópia para copiá-lo.
3. Todos os exemplos e testes da página passam a usar essa conexão.

Se a conexão ainda não tiver token, gere um em Conexões → Editar → Token.

Importante: guarde o token em local seguro. Ele funciona como uma senha e dá acesso ao envio de mensagens pela sua conta. Não compartilhe em código-fonte público, repositórios abertos ou mensagens não criptografadas.

3. Usar o token nas chamadas de API

Inclua o token no cabeçalho Authorization de todas as requisições:

Authorization: Bearer {seu-token-aqui}

Exemplo com cURL:

curl -X POST https://api.suaempresa.com/api/messages/send \
  -H "Authorization: Bearer {seu-token}" \
  -H "Content-Type: application/json" \
  -d '{"number": "5511999998888", "body": "Ola! Sua encomenda foi enviada."}'

4. Endpoints disponíveis

Mensagens

Endpoint	Método	Descrição
/api/messages/send	POST	Envia mensagem de texto ou mídia
/api/messages/send/linkImage	POST	Envia imagem a partir de uma URL
/api/messages/send/template	POST	Envia um template aprovado pela Meta (só conexão da API oficial)

Enviar mensagem de texto:

{
  "number": "5511999998888",
  "body": "Texto da mensagem"
}

Enviar mensagem com mídia: use multipart/form-data com o campo medias para anexar arquivos.

Opções adicionais para envio:

Campo	Tipo	Descrição
number	string	Número do destinatário com DDI (obrigatório)
body	string	Texto da mensagem (obrigatório)
whatsappId	number	Conexão que fará o envio. Sem isso, usa a conexão do token
queueId	number	ID da fila para direcionar a conversa
userId	number	ID do atendente para atribuir a conversa
sendSignature	boolean	Prefixa a mensagem com o nome do atendente
closeTicket	boolean	Fecha o ticket após envio
noRegister	boolean	Envia sem registrar a mensagem no histórico
msdelay	number	Atraso em milissegundos antes do envio

Enviar template (API oficial): na API oficial do WhatsApp, texto livre só chega a quem falou com o número nas últimas 24 horas. Para falar com quem não está nessa janela (código de verificação, lembrete, aviso), envie um template aprovado. O token precisa ser de uma conexão da API oficial, e o template precisa estar aprovado nessa mesma conexão (veja em Templates).

Campo	Tipo	Descrição
number	string	Número do destinatário com DDI, só dígitos, de 12 a 15 dígitos (obrigatório)
templateName	string	Nome do template aprovado (obrigatório)
language	string	Idioma do template. Padrão: pt_BR
params	string[]	Valores das variáveis do corpo, na ordem ({{1}}, {{2}}...). Obrigatório em template de autenticação
headerParams	string[]	Valores das variáveis do cabeçalho, na ordem. Em cabeçalho de imagem, vídeo ou documento, headerParams[0] é a URL da mídia

Exemplo, código de verificação (OTP) com um template de autenticação:

curl -X POST https://sua-instancia.paralela.com.br/api/messages/send/template \
  -H "Authorization: Bearer {seu-token}" \
  -H "Content-Type: application/json" \
  -d '{"number": "5511999998888", "templateName": "codigo_de_verificacao", "params": ["493817"]}'

Resposta: {"status": "SUCCESS", "ticketId": 12345}. Num template de autenticação, params[0] é o código: a Meta monta o texto ("493817 é seu código de verificação") e o botão Copiar código. O código não fica gravado na conversa; o histórico mostra só "Código de acesso enviado". Quem gera, guarda e confere o código e o seu sistema.

Erros específicos deste endpoint:

Código	Erro	O que fazer
400	ERR_API_TEMPLATE_NEEDS_OFFICIAL_CONNECTION	O token é de uma conexão que não é da API oficial. Use o token da conexão oficial
400	ERR_API_TEMPLATE_INVALID_NUMBER	Número sem DDI ou incompleto. Envie, por exemplo, 5511999998888
400	ERR_API_TEMPLATE_CODE_REQUIRED	Template de autenticação sem o código. Envie o código em params[0]
400	mensagem de validação (ex.: templateName is a required field)	Campo obrigatório ausente ou com tipo errado
403	Recurso de API externa não disponível no seu plano atual	O plano da empresa não inclui API externa
404	ERR_API_TEMPLATE_NOT_FOUND	Não há template aprovado com esse nome e idioma nessa conexão
502	ERR_API_TEMPLATE_SEND_FAILED: <motivo>	A Meta recusou o envio; o motivo dela vem depois dos dois-pontos. Não chegou ao destinatário

Todo erro volta no formato {"error": "<codigo ou mensagem>"}.

A página API de Mensagens documenta cada endpoint com a lista completa de campos, um exemplo de cURL pronto para copiar e — nos endpoints de envio, lead e verificação de número — um formulário para testar a chamada na hora.

Contatos

Endpoint	Método	Descrição
/api/messages/contact/create	POST	Cria um novo contato
/api/messages/contact/update	PUT	Atualiza dados de um contato
/api/messages/contact/{numero}	GET	Busca contato por número
/api/messages/contact/tag/sync	POST	Sincroniza tags de um contato

Tickets (conversas)

Endpoint	Método	Descrição
/api/messages/ticket/create	POST	Cria um novo ticket
/api/messages/ticket/{id}	GET	Busca ticket por ID
/api/messages/ticket/close	PUT	Fecha um ticket
/api/messages/ticket/transfer	PUT	Transfere ticket para outra fila ou atendente

Consultas

Endpoint	Método	Descrição
/api/messages/checkNumber	POST	Verifica se um número tem WhatsApp
/api/messages/tags	GET	Lista todas as tags
/api/messages/queues	GET	Lista todas as filas
/api/messages/users	GET	Lista todos os atendentes
/api/messages/whatsapps	GET	Lista todas as conexões WhatsApp

Leads

Endpoint	Método	Descrição
/api/messages/lead/create	POST	Cria um novo lead

5. Códigos de resposta

Código	Significado
200 / 201	Sucesso
400	Dados inválidos ou campo obrigatório ausente (normalmente o número fora do formato)
401	Token ausente ou inválido no cabeçalho Authorization
403	Seu plano não inclui o recurso de API externa (veja os planos da Paralela)
404	Contato, ticket ou conexão não encontrado
500	Erro interno do servidor

6. Boas práticas

• Armazene o token com segurança. Use variáveis de ambiente no seu sistema, nunca hardcode.
• Valide números antes de enviar. Use o endpoint /checkNumber para confirmar que o número tem WhatsApp ativo.
• Trate erros. Sempre verifique o código de resposta e implemente retentativas para falhas temporárias (5xx).
• Respeite limites. Evite enviar rajadas de mensagens. Espaçar envios reduz o risco de bloqueio pelo WhatsApp.
• Não envie spam. Mensagens não solicitadas violam os termos do WhatsApp e podem resultar em bloqueio da sua conexão.

7. Casos de uso

Cenário	Endpoints utilizados
Confirmação de pedido	/send para enviar mensagem + /contact/create para garantir que o contato existe
Lembrete de agendamento	/send com mensagem personalizada disparada pelo sistema de agenda
Código de verificação (OTP) no app	/send/template com um template de autenticação e o código em params
Pesquisa de satisfação	/send após fechamento do ticket + /ticket/close para finalizar
Importação de contatos	/contact/create em lote a partir do CRM
Roteamento de conversas	/ticket/create + /ticket/transfer para direcionar a fila correta

---

Servidor MCP (IA / Agentes)

O que é

O servidor MCP permite que clientes de IA externos (como o Claude Desktop, ou produtos próprios) operem a Paralela em linguagem natural, por meio do Model Context Protocol (MCP). Diferente da API de Mensagens — que é ideal para integrações diretas e determinísticas —, o MCP é voltado para agentes que decidem quais ações executar, cobrindo o mesmo conjunto de operações do Copilot: atendimentos, contatos, campanhas, fluxos, kanban, tarefas, agentes de IA, loja, relatórios e muito mais (cerca de 200 ferramentas, listadas na página do Servidor MCP).

Como funciona

1. Um administrador cria um token MCP em API de Mensagens → Servidor MCP (IA) (a operação exige permissão de administrador). O token é exibido uma única vez, junto com a configuração pronta para colar no cliente de IA.
2. O cliente de IA se conecta ao endpoint POST /mcp enviando Authorization: Bearer mcp_SEU_TOKEN.
3. O agente passa a executar ações com as permissões do usuário dono do token — ações sensíveis exigem confirmação em uma chamada seguinte, e o acesso pode ser revogado a qualquer momento excluindo o token.

A documentação completa (endpoint, autenticação, gestão de tokens e exemplo de configuração para o Claude Desktop) está em Servidor MCP.

---

Conectar o Seu Sistema de Gestão

O que é

Se a sua empresa já controla produtos e clientes em um sistema de gestão (ERP, PDV, sistema de delivery), você pode conectar esse sistema você mesmo, direto na tela de configurações. Não é preciso abrir chamado, nem pedir nada ao suporte, nem instalar coisa alguma.

Depois de conectado, a Paralela passa a buscar os dados no seu sistema de tempos em tempos: produtos com preço, estoque e disponibilidade sempre atualizados, sem cadastro em dobro.

Esta é a forma mais simples de manter os dois lados iguais. Se o seu sistema prefere enviar os dados em vez de ser consultado, a seção seguinte (Sincronização com Sistema Próprio) descreve esse outro caminho, que continua valendo.

Passo a passo

1. Abrir a tela

No menu lateral, abra Configurações Avançadas e, na categoria Integrações, clique no cartão Integrações. Se você não vê essa seção, é porque o seu usuário não tem a permissão de gerenciar as configurações da empresa — peça a um administrador.

2. Escolher o sistema

Em Sistemas disponíveis aparece um card para cada sistema de gestão que a Paralela sabe conectar. Clique em Conectar no card do seu.

3. Liberar o acesso

Daqui em diante existem dois caminhos, e a janela abre já no caminho certo para o sistema que você escolheu. Você não precisa saber qual é o seu de antemão.

Caminho A — o sistema usa usuário e senha

A janela pede o mesmo usuário e a mesma senha que você usa para entrar no seu sistema. A Paralela testa o acesso na hora:

• Deu certo: a janela fecha e o card do sistema aparece como conectado.
• Não deu: a mensagem aparece dentro da própria janela, em português, e o que você digitou continua lá. O erro mais comum é usuário ou senha incorretos — confira digitando no próprio sistema antes de tentar de novo.

A senha é guardada cifrada e nunca é exibida de volta nesta tela: mesmo depois de conectado, o campo de senha começa sempre vazio.

Caminho B — o sistema pede autorização (é o caso do Bling)

Alguns sistemas não liberam acesso por senha, e isso é uma proteção a seu favor: em vez de entregar a sua senha a alguém, você autoriza a Paralela de dentro do seu próprio sistema, e ele emite um acesso separado — que você pode cortar quando quiser, sem trocar senha nenhuma.

Nesse caminho a janela não tem campo de senha. Ao clicar em Autorizar no sistema:

1. abre uma janela do seu sistema;
2. você confere o que está sendo pedido e clica em autorizar;
3. a janela se fecha sozinha e o card já aparece conectado.

Se o seu navegador bloquear a janela, a mensagem diz exatamente isso — libere as janelas para o site da Paralela e clique de novo.

Se a janela pedir o Client ID e o Client Secret, é porque este ambiente ainda usa um aplicativo próprio da sua empresa dentro do sistema de gestão (no Bling: Preferências › Integrações › API para Desenvolvedores › Novo aplicativo). Esses dois valores não são a sua senha: eles só dizem qual aplicativo está pedindo permissão. Você continua autorizando na janela seguinte. Em ambientes com aplicativo público da Paralela, essa pergunta não aparece.

Nunca será pedido a você um "token de acesso" ou "refresh token". Esse valor não existe antes da autorização — ele é justamente o que ela produz, e quem cuida dele é a Paralela.

Este acesso não vence sozinho

Nos sistemas do Caminho B, o acesso emitido tem prazo de validade — no Bling, trinta dias. A Paralela renova sozinha, em segundo plano, antes de o prazo chegar perto — inclusive enquanto a sua sincronização está pausada, porque o relógio do seu sistema não para junto com ela.

Você não precisa fazer nada, e não existe um dia em que a conexão "expira" e pede para reconectar. Se você quiser encerrar o acesso, isso continua sendo uma decisão sua: Desconectar aqui, ou revogar a autorização de dentro do seu próprio sistema.

4. Escolher a unidade (só quando existe mais de uma)

Se o seu acesso alcança mais de uma loja, filial ou depósito, a janela pergunta qual é a sua e mostra a lista com os nomes que você já conhece do seu sistema. Escolha e clique em Conectar de novo.

Essa pergunta só aparece quando ela existe de verdade: acesso de uma unidade só não pergunta nada. A unidade escolhida passa a valer para tudo — os pedidos que a Paralela enviar são arquivados nela, e os dados que a Paralela buscar vem dela. Para trocar depois, use Atualizar acesso e escolha outra.

O que você vê depois de conectado

Item	O que significa
Status	Ativa (funcionando), Precisa de atencao (a última tentativa falhou, veja a mensagem no card) ou Pausada (você parou a sincronização)
Última sincronização	Quando a Paralela buscou dados no seu sistema pela última vez
Mensagem de erro	O motivo da última falha, em português. Ela some sozinha quando uma sincronização der certo
Registros que ficaram de fora	Quantos cadastros do seu sistema a Paralela não conseguiu ler — veja Quando um cadastro do seu sistema fica de fora
Chaves por recurso	Uma chave para cada tipo de dado. Você decide o que a Paralela pode trazer
Sincronizar agora	Coloca uma busca na fila imediatamente, sem esperar a próxima rodada. Veja Sincronizar agora
Pausar / Retomar	Para tudo por um tempo, sem apagar nada. Veja Pausar sem desconectar
Atualizar acesso	Use quando a senha do seu sistema mudar. É o conserto do status Precisa de atencao
Desconectar	Apaga a senha do seu sistema e para a sincronização

Os recursos, um a um

Recurso	Sentido	O que faz	Como nasce
Produtos	Mão dupla	Traz os produtos do seu sistema e cadastra lá os que você criar aqui	Ligado
Clientes	Mão dupla	Reconhece no seu sistema quem está falando com você, e cadastra lá os contatos criados aqui	Desligado
Pedidos	Da Paralela para o seu sistema	Cria no seu sistema os pedidos fechados na Paralela	Desligado
Agendamentos	Da Paralela para o seu sistema	Ainda não disponível para nenhum sistema	—
Cobranças	Do seu sistema para a Paralela	Traz os boletos em aberto, para consulta e para lembretes automáticos	Desligado
Acompanhamento de pedidos e OS	Do seu sistema para a Paralela	Traz os pedidos de venda e as ordens de serviço, para a IA dizer ao cliente como está o pedido ou o conserto dele	Desligado

Produtos e Clientes andam nos dois sentidos; Cobranças e Acompanhamento de pedidos e OS a Paralela só busca; Pedidos e Agendamentos ela só envia. Os dois recursos que escrevem dentro do seu sistema — Produtos e Pedidos — merecem uma leitura a parte: veja Produtos nos dois sentidos e Enviar pedidos para o seu sistema.

Cada sentido tem o seu interruptor. Ligar Produtos traz os produtos do seu sistema para cá — e só isso. Abaixo dele aparece um segundo interruptor, "Enviar para o meu sistema os produtos criados aqui", que nasce desligado. Você pode ficar só recebendo pelo tempo que quiser.

Nem todo sistema aceita receber produto. O card diz qual é o caso do seu: onde o seu sistema só entrega a lista, o segundo interruptor nem aparece. Aí o produto cadastrado aqui fica só aqui.

Por que "Clientes" nasce desligado: ligar essa chave é você autorizando a Paralela a olhar a sua base de clientes. Enquanto ela estiver desligada, a Paralela não pergunta nada sobre os seus clientes ao seu sistema.

"Clientes" funciona de dois jeitos, conforme o seu sistema

Nem todo sistema de gestão entrega a lista de clientes, e nem todo sistema precisa entregar. O texto no próprio card diz qual é o caso do seu.

O seu sistema	O que a chave Clientes faz	A sua base é copiada para a Paralela?
Sabe entregar a lista inteira	A Paralela traz os clientes cadastrados, de tempos em tempos	Sim
Só sabe responder por telefone	Quando alguém chama, a Paralela pergunta ao seu sistema quem é o dono daquele número	Não

O segundo caso é o mais comum, e o KP Delivery é um deles: a tela de clientes dele é uma busca — você digita um nome ou um telefone e ele responde —, não uma listagem. Isso não é uma limitação do que a Paralela faz por você: uma conversa de WhatsApp começa justamente com um telefone, que é exatamente a pergunta que o seu sistema sabe responder.

Na prática, com um sistema de consulta:

• o cliente manda mensagem e a Paralela pergunta ao seu sistema quem é o dono daquele número;
• achou um cadastro: a conversa passa a ficar ligada aquele cliente do seu sistema, e os campos vazios do contato aqui (e-mail e documento) são preenchidos com o que ele já tem lá;
• não achou: é um cliente novo, e a Paralela guarda que perguntou — ela não fica perguntando de novo a cada mensagem;
• achou mais de um (linha compartilhada, casa com dois cadastros, loja e dono): a Paralela não escolhe. Escolher errado mandaria a entrega para o endereço de outra pessoa, e nada pareceria errado até a entrega chegar na porta errada. Quem sabe qual é o certo é você.

Quando o telefone tem mais de um cadastro e sai um pedido, o pedido não é lançado e aparece como Não entregue na fila de saída, dizendo que há mais de um cliente com aquele telefone. É de propósito: um pedido parado você reenvia depois de acertar os cadastros no seu sistema; uma entrega no endereço errado não tem desfazer.

A pergunta é feita quando uma conversa nova começa — no máximo uma vez por dia para cada contato. Um cliente que se cadastrou no seu sistema depois (inclusive por causa de um pedido que saiu da Paralela) passa a ser reconhecido na próxima conversa dele. Disparo de campanha e importação de histórico não consultam o seu sistema: a pergunta só vale quando há alguém do outro lado conversando.

O que continua valendo nos dois casos: o nome do contato nunca é trocado pelo do seu sistema, e só campos vazios (e-mail e documento) são preenchidos. Veja O que a sincronização NÃO faz.

Por que "Pedidos" nasce desligado: é o único recurso que cria registro dentro do seu sistema de gestão. Ele só passa a valer quando você liga a chave, e a partir dali cada pedido fechado na Paralela vira um pedido lá.

Quando um cadastro do seu sistema fica de fora

De vez em quando um cadastro do seu sistema chega incompleto ou com um dado que a Paralela não consegue interpretar: um boleto sem data de vencimento, um cliente sem nome, um produto com preço em branco. Nesses casos o card mostra quantos registros ficaram de fora.

O que você precisa saber sobre esse aviso:

• A sincronização continua rodando. Os outros cadastros entram normalmente; só os que a Paralela não conseguiu ler ficam de fora.
• Nada é apagado. O registro continua existindo no seu sistema, exatamente como está.
• Ele volta sozinho. Assim que o cadastro for corrigido no seu sistema, a próxima rodada o traz e a contagem cai — você não precisa avisar ninguém nem clicar em nada.
• Contagem que não cai por dias é o sinal de que o cadastro precisa de um ajuste lá: o campo que falta é sempre um campo obrigatório para o próprio sistema de gestão.

Se você não souber quais são os registros, fale com o suporte: o motivo de cada um fica registrado do lado da Paralela.

Enviar pedidos para o seu sistema

O recurso Pedidos é o único que escreve no seu sistema de gestão. Ligue a chave Pedidos no card da integração e, a partir daquele instante, cada pedido fechado na Paralela é enviado para o seu sistema automaticamente. Pedidos fechados antes de você ligar a chave não são enviados.

O que acontece a cada pedido:

1. o pedido entra na fila de saída no mesmo instante em que é criado na Paralela;
2. a Paralela o envia ao seu sistema, com o mesmo usuário e a mesma senha que você informou ao conectar;
3. quando o seu sistema confirma, a entrega aparece como Entregue e guarda o número que ele devolveu.

Se algo der errado, a fila mostra o que aconteceu e o que — se é que — você precisa fazer:

Situação	O que você vê	O que fazer
O seu sistema estava fora do ar	A entrega é tentada de novo sozinha	Nada
O seu sistema recusou o pedido (falta um dado, por exemplo)	Não entregue, com o motivo na coluna de erro	Corrija a causa e use Reenviar
A senha do seu sistema mudou	O card fica em Precisa de atenção	Use Atualizar acesso e depois Reenviar as entregas paradas
A resposta do seu sistema não chegou	Precisa de conciliação — por pouco tempo, na maioria dos casos	Normalmente nada: a Paralela confere sozinha. Veja Entregas sem resposta conclusiva

O que faltar no seu sistema, o pedido cria

O pedido leva junto o cadastro de quem está comprando e o dos produtos que ele lista. Se o seu sistema já conhece o cliente e os itens, nada é escrito — ele só aponta para o que já está lá. Se não conhece, o cadastro que falta é criado na hora e o pedido segue.

Isso vale independentemente dos interruptores de Clientes e Produtos: eles decidem se a Paralela empurra cadastros por conta própria, e este caso é outro — é o cadastro que aquele pedido precisa para existir. Autorizar o envio de pedidos e autorizar o cliente e o item que o pedido nomeia.

Nada é cadastrado duas vezes. O cliente é procurado pelo telefone antes de qualquer escrita, e o produto pelo nome; quem já está lá é usado como está. Um telefone que responda por mais de um cadastro faz a Paralela recusar em vez de escolher — escolher seria decidir para qual endereço vai a próxima entrega.

Quando ainda assim não dá. Alguns sistemas exigem endereço completo para aceitar um cliente novo, e não há como inventar isso. Nesse caso a entrega aparece como Não entregue e a coluna de erro diz exatamente o que perguntar ao cliente (rua, número, bairro, cidade). Preencha o endereço no contato e use Reenviar — nada foi criado, então o reenvio é seguro. O CEP não entra nessa lista: a Paralela o descobre a partir do resto do endereço.

Orçamento não cadastra nada. Perguntar quanto custa um item é uma pergunta, e a resposta para um item que o seu sistema não tem é que ele não tem.

Um pedido nunca é enviado duas vezes por conta própria. Quando a Paralela não consegue saber se o envio chegou, ela para em vez de mandar de novo: um envio repetido criaria um segundo pedido para a mesma venda dentro do seu sistema, e isso não tem desfazer.

Para parar de enviar, desligue a chave Pedidos. As entregas que já estão na fila seguem o desfecho delas; nenhum pedido novo entra — e os pedidos fechados com a chave desligada não são enviados depois. Se o que você quer é parar tudo por um tempo — porque está mexendo no seu sistema, por exemplo —, use Pausar: ali nada é perdido, os pedidos entram na fila e esperam até você retomar.

Produtos nos dois sentidos

São dois interruptores, e você escolhe quantos quer:

Interruptor	O que faz	Nasce
Produtos	Traz os produtos do seu sistema para cá, a cada 15 minutos: preço, estoque e disponibilidade	Ligado
Enviar para o meu sistema os produtos criados aqui	Cadastra no seu sistema, na hora, o produto que você criar na tela de produtos da Paralela	Desligado

Só receber é o padrão, e continua sendo uma escolha valida para sempre. O segundo interruptor fica logo abaixo do primeiro e só pode ser ligado com o recurso ligado; desligar Produtos não apaga a sua escolha — ela volta como estava quando você religar.

O código do produto passa a ser o do seu sistema. Ele gera o código dele próprio ao cadastrar — e ignora o que a Paralela mandar —, então assim que o cadastro volta, o SKU do produto aqui é trocado por ele. É isso que faz os dois lados falarem do mesmo produto: sem essa troca, a próxima sincronização veria o produto recém-criado como desconhecido e cadastraria um segundo aqui dentro.

Com o envio ligado, três coisas valem saber antes:

• Só a criação vai. Mudar o preço aqui não muda o preço lá. Depois que o produto existe nos dois lados, quem manda no preço é o seu sistema, e a sincronização o traz de volta a cada 15 minutos.
• Produto com o mesmo nome não vira duplicata. Se o seu sistema já tiver um produto com aquele nome, a Paralela adota o que já está lá em vez de cadastrar outro.
• Ele entra no grupo que os seus outros produtos usam. Sistemas de gestão exigem grupo e unidade, e a Paralela não inventa nenhum dos dois: usa o que a sua própria lista mostra, ou o que casar com a categoria do produto. Num sistema com o cadastro de produtos vazio não há o que copiar, e aí o envio para e pede que você cadastre um produto lá primeiro.

Clientes nos dois sentidos

Mesmo par de interruptores dos Produtos:

Interruptor	O que faz	Nasce
Clientes	Reconhece no seu sistema quem está chamando, pelo telefone	Desligado
Cadastrar no meu sistema os contatos criados aqui	Cadastra lá, na hora, o contato criado na Paralela	Desligado

O endereço que já está no seu sistema vem junto. Quando a Paralela espelha a sua base de clientes, ela traz também o endereço de entrega de cada um — o que o seu sistema marca como principal. É o que impede a IA de perguntar onde mora um cliente que compra na mesma casa há três anos: o cadastro já sabia. O endereço entra só quando o contato ainda não tem um aqui; o que o cliente informou na conversa, ou o que a sua equipe digitou, é sempre mais novo e nunca é sobrescrito. Na primeira sincronização depois desta mudança, a base inteira passa de novo para ganhar o endereço que faltava.

Precisa do endereço em campos separados. Sistemas de gestão que despacham entrega exigem rua, número, bairro, cidade e UF como campos distintos, e a Paralela não corta a linha única de endereço em pedaços: "Rua 14, Conselheiro, Bairro Bela Vista, Cabo de Santo Agostinho/PE" tem quatro vírgulas e cinco leituras possíveis, e a errada põe o entregador na porta de outra pessoa. Por isso o endereço do contato fica em campos separados — os mesmos que o cliente gerencia na loja virtual, na mesma lista. Um contato pode ter mais de um endereço; o marcado como padrão é o que vai no pedido. Sem ele preenchido, o cadastro é recusado com o motivo na tela em vez de sair torto. Ver Endereço de entrega.

A IA não pergunta o CEP — ela descobre. Quem compra gás não sabe o próprio CEP de cor, e ninguém numa revenda pergunta isso: o entregador vai pela rua e pelo bairro. Só que o sistema de gestão resolve o CEP antes de aceitar um endereço. Então a Paralela pergunta aos Correios no lugar do cliente: com a rua, o bairro e a cidade, o CEP vem de lá sozinho. A conversa fica com as quatro perguntas que fazem sentido — rua, número, bairro e cidade.

Quando os Correios não conhecem a rua, a Paralela procura pelo bairro; e quando nem isso responde, adota um CEP do próprio município, que é o que faz o cadastro entrar no sistema do lojista sem travar a venda. O endereço que o entregador lê continua sendo o que o cliente disse.

Se o cliente informar o CEP por conta própria, ele é conferido. Oito dígitos não quer dizer que o CEP exista — "54500-000" tem cara de CEP geral da cidade e não existe. Um CEP que os Correios não conhecem não é salvo, e a Paralela usa no lugar dele o que a rua responde, sem transformar isso em pergunta. O CEP válido manda na cidade e na UF, porque é contra eles que o sistema do lojista compara o endereço; se isso corrigir o que o cliente falou, a IA avisa e confirma. Rua e bairro nunca são sobrescritos: quem sabe o nome da própria rua é o cliente.

Correios fora do ar não trava nada: o endereço é salvo como o cliente informou, e a descoberta volta a valer sozinha.

Duas coisas que valem saber:

• Cliente que já existe lá não vira duplicata. Antes de cadastrar, a Paralela procura pelo telefone; se achar, adota o cadastro que já está lá. Se o telefone estiver em mais de um cadastro, ela não escolhe — escolher errado manda a entrega para o endereço de outra pessoa.
• Só a criação vai. Mudar o nome ou o endereço aqui não muda o cadastro lá. Depois que a pessoa existe nos dois lados, quem manda no cadastro é o seu sistema.
• O que veio de lá não volta para lá. Os clientes e os produtos que a Paralela traz do seu sistema não entram na fila de envio: eles já estão cadastrados, e reenviá-los só ocuparia a fila e encheria a lista de Entregas paradas com erros que não descrevem erro nenhum. O interruptor de envio vale para o que você cadastra aqui.

Este interruptor não é o que faz um pedido funcionar. O pedido cria por conta própria o cliente que precisa — veja O que faltar no seu sistema, o pedido cria. Ligue este aqui quando quiser que todo contato novo apareça no seu sistema, tenha ele comprado ou não.

Boas-vindas ao novo cliente do sistema

Quando alguém passa a aparecer na lista de clientes do seu sistema de gestão — por exemplo, quando vira associado —, a Paralela pode iniciar um fluxo de boas-vindas (onboarding) para essa pessoa, sozinha. Para isso:

1. Deixe ligada a chave Clientes do sistema.
2. No Flow Builder, crie um fluxo com o gatilho Novo cliente no sistema integrado (categoria Contatos) e escolha a conexão por onde a mensagem deve sair.

O gatilho vale tanto para quem nunca tinha falado com você quanto para quem já era um contato seu e acabou de ser cadastrado no sistema: o que conta é entrar na lista do sistema, e não ser criado aqui.

Quem recebe, e quem não recebe:

• A base que já existia não recebe nada. A primeira leitura completa da lista de clientes serve só para a Paralela aprender quem já estava lá. Enquanto ela não termina, nenhum fluxo dispara — mesmo que você já tenha criado o gatilho. Quem estava na lista mas tinha um cadastro com problema também conta como "já estava lá".
• Cada pessoa dispara uma vez só. Se o telefone mudar ou se a leitura rodar de novo, ela não recebe outra vez. Dois cadastros do seu sistema com o mesmo telefone (por exemplo, responsável e dependente) contam como uma pessoa só: só o primeiro dispara.
• Cadastro em massa não dispara tudo. Por segurança, no máximo 25 pessoas por leitura e 100 por dia recebem o fluxo. O que passar disso fica registrado como suprimido, em vez de uma rajada de mensagens — importar uma base inteira de uma vez não conta como "novos associados chegando".
• Só em sistemas que reoferecem a lista inteira a cada volta (hoje, o HiGestor). Em sistemas que só mandam o que mudou desde a última leitura, um cliente antigo que foi apenas atualizado pareceria novo, e por isso o gatilho não dispara neles.

Gatilho de fluxo, não de webhook

Este evento só existe como gatilho de fluxo. Como o contato vem do sistema de gestão e não de uma conversa, a conexão escolhida no gatilho define apenas por qual número o fluxo sai — ela não filtra quais clientes disparam.

Um cuidado que vale saber: o fluxo sai na leitura seguinte ao cadastro, não no segundo em que a pessoa é cadastrada no seu sistema. A Paralela lê a lista de clientes de tempos em tempos (veja abaixo), então o atraso é o da frequência da leitura.

Com que frequência acontece

• Produtos: a leitura, a cada 15 minutos, aproximadamente. O envio de um produto novo — se você tiver ligado o segundo interruptor — sai na hora.
• Clientes, quando o seu sistema entrega a lista: a cada hora, aproximadamente.
• Clientes, quando o seu sistema só responde por telefone: quando o cliente chama, e no máximo uma vez por dia para cada contato. Campanha e importação de histórico não contam.
• Pedidos: na hora — cada pedido é enviado assim que é fechado na Paralela.
• Acompanhamento de pedidos e OS: a cada 15 minutos, aproximadamente.

A primeira busca começa poucos minutos depois de você conectar. Não é preciso ficar na tela esperando.

Em sistemas com muitos cadastros, cada rodada lê vários lotes seguidos em vez de um só. E, enquanto sobrar base para ler, a rodada seguinte não espera a frequência da tabela acima — ela recomeça em cerca de um minuto, até a primeira volta completa terminar. É por isso que uma base de milhares de cadastros entra em minutos, e não ao longo do dia. Quando a volta fecha, a sincronização volta ao ritmo normal da tabela.

Sincronizar agora

O botão Sincronizar agora coloca uma busca na fila na hora, sem esperar a próxima rodada. Ele não espera a busca terminar: a Paralela avisa que a sincronização começou, o card fica em Sincronizando... e o resultado aparece nele quando a volta terminar — em geral em até alguns minutos, dependendo do tamanho da sua base e de quão rápido o seu sistema responde.

Duas coisas seguem disso:

• Você pode sair da tela. A busca roda no nosso servidor e não depende da aba aberta. Voltando depois, a Última sincronização do card mostra quando ela terminou.
• Clicar de novo não adianta. Enquanto uma busca daquele sistema estiver na fila ou rodando, o botão avisa que já há uma em andamento em vez de começar uma segunda. Duas buscas ao mesmo tempo no mesmo sistema podem fazer ele bloquear o seu acesso por excesso de conexões.

Com Cobranças ligada a volta é mais longa, porque a lista de boletos costuma ser a maior do sistema. Cada rodada lê um pedaço e continua de onde parou na próxima — nada é perdido no meio.

O que a Paralela não faz com os seus dados

Vale exatamente o mesmo que está descrito em O que a sincronização NÃO faz: a sua vitrine, as suas fotos, os seus descontos e os nomes dos seus contatos ficam como você deixou. Nada é apagado.

Pausar sem desconectar

Pausar para tudo por um tempo e não apaga nada. É o botão para quando você está arrumando o catálogo no seu sistema, ou quando o preço de lá está errado e você não quer que ele desça para a sua vitrine agora.

Enquanto estiver pausada:

• a Paralela para de buscar produtos e clientes no seu sistema;
• os pedidos fechados durante a pausa entram na fila de saída e esperam lá, junto com os que já estavam. Nenhum é enviado e nenhum é perdido: todos saem quando você retomar, e todos ficam visíveis na fila enquanto isso;
• a senha do seu sistema continua guardada, e as chaves dos recursos ficam como você as deixou;
• Sincronizar agora avisa que a sincronização está pausada, em vez de buscar.

Retomar é um clique no mesmo lugar. Não há o que redigitar: a integração volta para o mesmo estado em que estava — inclusive Precisa de atencao, se era esse o caso quando você pausou.

Pausar não pede confirmação, porque é reversível. Desconectar pede, porque não é.

Você quer	Use
Parar um tipo de dado e continuar com o resto	Desligue a chave daquele recurso
Parar tudo por um tempo, sem perder nada	Pausar
Tirar a senha do seu sistema do nosso banco	Desconectar

Desconectar

O botão Desconectar pede confirmação e, ao confirmar:

• a senha do seu sistema é apagada do nosso banco;
• a sincronização para;
• os produtos e contatos que já entraram continuam aqui, como qualquer cadastro seu;
• a fila de saída continua na tela enquanto houver entrega pendente, morta ou esperando conciliação. Desconectar não apaga o que ficou para trás, e você continua podendo conferir e resolver cada linha.

Para voltar, é só conectar de novo informando o acesso. Se você quer apenas parar por um tempo, use Pausar em vez de desconectar — assim a senha continua guardada e voltar é um clique. Para parar só um tipo de dado, desligue a chave daquele recurso.

Trocar a senha de uma integração pausada não a retoma: use Atualizar acesso para corrigir o acesso e Retomar quando quiser que ela volte a funcionar.

---

Cobranças e lembretes automáticos

Disponível nos sistemas de gestão que trabalham com boleto. Ligando a chave Cobranças, a Paralela passa a trazer para cá os boletos em aberto dos seus clientes — valor, vencimento, link da segunda via, linha digitável e Pix.

Isso serve para duas coisas:

1. Responder quem pergunta. O cliente escreve "quero minha segunda via" e a IA responde com as cobranças dele, sem ninguém da sua equipe procurar nada. Precisa estar ligada também a ferramenta correspondente no assistente de IA.
2. Lembrar quem esqueceu. A Paralela manda sozinha uma mensagem no WhatsApp perto do vencimento e depois dele, conforme a regra que você definir.

A IA responde já na primeira mensagem, inclusive de quem nunca escreveu para você antes: ela reconhece o cliente pelo próprio número de WhatsApp e acha as cobranças dele na hora, sem esperar a próxima sincronização. O que ela nunca faz é aceitar um CPF ou CNPJ digitado na conversa para procurar o boleto de outra pessoa — quem não for reconhecido pelo número é encaminhado ao seu atendimento.

E quando a leitura do seu sistema estiver momentaneamente atrasada, a IA não diz que o cliente está em dia: ela avisa que a consulta está desatualizada e passa o atendimento para a sua equipe. Dizer "você não deve nada" e mandar um lembrete de vencimento logo depois seria pior do que não responder.

Nada é enviado até você mandar. A chave nasce desligada e, mesmo depois de ligada, a régua de lembretes nasce em modo simulação: ela faz a conta inteira e não envia nada. Você vê o número antes de qualquer mensagem sair.

A régua de lembretes

A régua aparece dentro do próprio card do sistema conectado, logo abaixo das chaves, assim que você liga Cobranças.

Campo	O que faz
Enviar lembretes automaticamente	A chave geral. Desligada, nada roda
Modo simulação	Ligado, a Paralela calcula tudo e não envia nada. Nasce ligado
Enviar pela conexão	De qual dos seus números as cobranças saem. Sem escolher, nada é enviado
Número de teste	Opcional. Com um número aqui, os lembretes saem só para ele, em vez de para os clientes. Veja Testar sem cobrar ninguém
Dias do lembrete	Quando avisar, contado a partir do vencimento. 0 é o próprio dia do vencimento, negativo é antes, positivo é depois. Ex.: -3, 0, 7 avisa três dias antes, no dia, e sete dias depois
A partir das / Até as	A janela de horário. Fora dela a Paralela não envia — e não acumula para mandar tudo junto quando abrir
Dias da semana	Em quais dias os lembretes podem sair
Não cobrar após (dias)	Dívida mais velha que isso é ignorada. Padrão: 90 dias
Máximo por ciclo / por dia	Tetos de quantas mensagens saem de uma vez e por dia. O que sobra entra na próxima rodada
Texto da mensagem	Vazio usa o texto padrão. Aceita variáveis — veja abaixo

Simular antes de ligar

O botão Simular agora roda a seleção inteira sem enviar nada e responde, por exemplo:

Seriam 96 mensagens para 96 associados. Alcance de hoje: vencimentos de 12/08/2026 a 22/08/2026. No espelho há 457 cobranças em aberto. 46 ficam para os próximos ciclos. 122 com vencimento fora dos degraus de hoje. 166 sem celular válido, fora do envio.

Quem foi identificado: Academia Exemplo — vence 22/08/2026 — 2 cobranças — R$ 218,70 ...

Além de quantas mensagens saem, a simulação mostra quem foi identificado (os 25 primeiros) e, para cada cliente que ficou de fora, por que. Simule quantas vezes quiser — simular nunca envia.

A linha do alcance é a que costuma responder "e o fulano, por que não apareceu?". Os degraus da régua só olham uma faixa de vencimentos: um boleto que vence fora dela não entra na conta — nem como enviado, nem como descartado. Comparando a faixa com o total em aberto você vê na hora se falta ajustar os degraus ou se o boleto ainda não chegou do seu sistema.

Procurar um vencimento específico

Ao lado de Simular agora há o campo Buscar um vencimento: escolha uma data e clique em Buscar nesta data para ver quem tem boleto vencendo exatamente naquele dia — sem precisar calcular quantos dias faz de hoje até lá.

Essa busca é avulsa: ela não altera a régua, não conta como simulação e não aparece depois na tela. Clique em Voltar a régua para ver de novo o resultado da última simulação de verdade.

Quando você desliga o modo simulação, a Paralela pergunta uma vez, dizendo quantas mensagens a última simulação apontou e por qual número elas sairão.

O texto da mensagem

Deixando o campo vazio, a Paralela monta um texto que começa pelo nome de quem deve e termina avisando para desconsiderar se já pagou. As duas coisas são de propósito: telefone de recepção e celular compartilhado existem, e um pagamento feito hoje de manhã no banco pode ainda não ter chegado aqui.

Escrevendo o seu próprio texto, use estas variáveis entre chaves duplas:

Variável	O que vira
nome	Nome de quem deve
valor	Total das cobranças citadas
vencimento	Vencimento da mais antiga
descricao	Do que se trata
cobrancas	A lista, uma por linha, quando houver mais de uma
link	Link da segunda via
linhaDigitavel	Linha digitável do boleto
pix	Pix copia e cola
outrasCobrancas	As outras cobranças já vencidas do mesmo cliente, uma por linha e cada uma com o seu link. Vazio quando não há
outrasQuantidade	Quantas são
totalEmAberto	Total em aberto: a cobrança da mensagem mais as outras vencidas

Quem deve mais de uma cobrança

O que dispara a mensagem e o vencimento cair num degrau da régua. O que vai nela é tudo o que o cliente deve:

• Mesmo vencimento: uma mensagem só, listando as cobranças.
• Vencimentos diferentes (por exemplo, mensalidades de meses seguidos): cada um recebe a mensagem no dia do seu degrau, e cada mensagem traz também as outras cobranças já vencidas do cliente, com o link de cada uma e o total em aberto. Quem deve seis meses não recebe seis avisos no mesmo dia nem um aviso por cobrança: recebe um aviso por vencimento que chegou a um degrau, já consolidado.
• Passou do último degrau: a cobrança antiga não dispara mais mensagens sozinha, mas continua aparecendo na lista de quem dispara por outra cobrança. Para insistir por mais tempo, acrescente degraus em Dias do lembrete (por exemplo -3, 0, 7, 15, 30).

A lista segue os mesmos limites da régua: cobrança paga, abaixo do valor mínimo ou mais velha que Não cobrar após (dias) não entra. Cinco aparecem por extenso, o resto vira "e mais N". Um texto personalizado só inclui essa lista se usar outrasCobrancas.

Testar sem cobrar ninguém

Para ver a mensagem chegar de verdade sem mandar cobrança para cliente real, preencha Número de teste. Enquanto ele estiver preenchido e o envio estiver ligado (fora do modo simulação):

• todo lembrete sai só para o número de teste, com a primeira linha dizendo para quem ele iria ([TESTE] Esta mensagem iria para ...);
• o texto, os valores, o link do boleto e a lista de outras cobranças são os de verdade;
• ele não espera a janela de horário, mas tem tetos próprios: no máximo 10 por ciclo e 20 por dia;
• o que foi para o número de teste não conta como enviado: quando você apagar o número, os clientes ainda vão receber o aviso normalmente;
• salvar uma alteração na régua reinicia o teste: mude o texto ou os degraus, salve, e o teste repete as mesmas mensagens.

Cobrança de um cliente sem contato ligado continua falhando no teste, como falharia de verdade. Para voltar ao envio normal, apague o número de teste.

O que a Paralela nunca faz

• Não manda duas vezes o mesmo aviso. Cada degrau da régua sai uma vez por cliente, por cobrança. Se a sincronização rodar dez vezes no dia, o cliente recebe uma mensagem
• Não manda várias mensagens por causa do mesmo vencimento. Boletos do mesmo cliente que vencem no mesmo dia vão numa mensagem só. Boletos com vencimentos diferentes são avisados cada um no seu dia, mas a mensagem de cada um lista também as outras cobranças vencidas do cliente — veja abaixo
• Não cobra quem não deve. Boleto pago ou cancelado no seu sistema sai da lista sozinho
• Não envia para quem não tem celular no cadastro. Esses clientes aparecem no número da simulação, para você saber quantos são
• Não esconde quem ficou de fora. Todo cliente descartado entra em algum dos motivos da simulação: fora dos degraus de hoje, já pago ou cancelado, abaixo do valor mínimo, vencido há tempo demais, sem celular, ou parado de vir do seu sistema
• Não envia fora da janela que você definiu, e não guarda para mandar tudo assim que ela abrir

Um cuidado que vale saber: a Paralela lê o seu sistema de tempos em tempos, então um boleto pago agora há pouco pode levar algumas horas para sumir daqui. É por isso que o texto padrão termina com "se você já pagou, desconsidere" — é por isso que o primeiro aviso depois do vencimento não sai no dia seguinte.

---

Acompanhamento de pedidos e ordens de serviço

Disponível nos sistemas de gestão que trabalham com pedido de venda e ordem de serviço (hoje, o Bling). Ligando a chave Acompanhamento de pedidos e OS, a Paralela passa a trazer para cá os pedidos e as OS do seu sistema — número, situação, data de abertura, previsão e valor.

Isso serve para uma coisa: responder quem pergunta. O cliente escreve "como está minha ordem de serviço?" ou "meu pedido já saiu?" e a IA responde com a situação que está no seu sistema, com as mesmas palavras que você usa lá ("Em andamento", "Pronto para retirada"). Ela mostra o que está em aberto e o que foi finalizado nos últimos 30 dias.

Para funcionar, precisam estar ligados:

1. a chave Acompanhamento de pedidos e OS;
2. a chave Clientes do mesmo sistema — é ela que permite a Paralela reconhecer, pelo número de WhatsApp, quem é o cliente no seu sistema;
3. a ferramenta Consultar pedidos e ordens de serviço do cliente no assistente de IA.

A IA só fala do cliente que está conversando. Ela reconhece a pessoa pelo próprio número de WhatsApp e nunca aceita um número de pedido, de OS ou um CPF digitado na conversa para consultar o pedido de outra pessoa. Quando o mesmo telefone está em mais de um cadastro no seu sistema, ela não escolhe um: avisa que o atendimento precisa confirmar.

E quando a leitura do seu sistema estiver momentaneamente atrasada, a IA não diz que não há pedido: ela avisa que a consulta está desatualizada e passa o atendimento para a sua equipe.

Um cuidado que vale saber: a Paralela lê o seu sistema de tempos em tempos, então uma mudança de situação feita agora há pouco pode levar um tempo para aparecer na resposta da IA — em sistemas com muitos pedidos, algumas horas.

---

Sincronização com Sistema Próprio

O que e

Se a sua empresa já controla produtos e clientes em um sistema próprio (ERP, PDV, sistema de gestão), a sincronização evita o cadastro em dobro. Um intermediário chamado Paralela Connect lê os dados do seu sistema e os envia para a Paralela em lotes, de forma automática e periódica.

O sentido do fluxo é sempre do seu sistema para a Paralela. A Paralela não altera nada no seu ERP.

Como ativar

1. Um administrador cria um token de sincronização (a operação exige permissão de administrador). O token é exibido uma única vez — copie e guarde no momento da criação.
2. Esse token é configurado no Paralela Connect, que passa a enviar os lotes de produtos e contatos.
3. Para revogar o acesso, basta excluir o token: o envio para de ser aceito imediatamente.

Este caminho continua valendo e é o indicado quando o seu sistema envia os dados. Se você prefere que a Paralela busque os dados sozinha, sem token e sem configuração externa, veja Conectar o Seu Sistema de Gestão.

O que a sincronização faz

Dado	Como é identificado	O que acontece
Produtos	Pelo SKU dentro da sua empresa	Se o SKU ainda não existe, o produto é criado. Se já existe, ele é atualizado
Contatos	Pelo número de telefone dentro da sua empresa	Se o número ainda não existe, o contato é criado. Se já existe, apenas campos vazios são preenchidos

Nos produtos, a sincronização mantém atualizados: título, preço, descrição, categoria, tipo (produto ou serviço), estoque e disponibilidade.

Serviço não tem estoque. Sistemas de gestão guardam mão de obra ("Instalação de placa de vídeo", "Reparo eletrônico") com saldo zero, porque não há nada numa prateleira para contar. Quando o seu sistema informa que a linha é um serviço, a Paralela a cadastra como serviço e para de olhar o estoque dela — senão todo serviço que você vende apareceria como "indisponível" e a IA diria isso ao seu cliente. Produto físico com saldo zero continua indisponível, como sempre foi.

A descrição chega em texto limpo. Muita loja escreve a descrição no Word e cola no sistema de gestão, e o que fica gravado lá é a formatação junto (<p style=...>, <span>,  ). A Paralela remove essa formatação e guarda o texto, preservando as quebras de linha e as listas — e o que o cliente lê no WhatsApp é o que aparece na sua vitrine. Descrição muito longa é aparada, nunca motivo para o produto ser recusado.

O que a sincronização NÃO faz

Esta é a parte mais importante: o trabalho que você fez dentro da Paralela não é sobrescrito.

• A loja virtual é preservada. A sincronização nunca altera se o produto está publicado na loja, a ordem em que ele aparece, as fotos, as palavras-chave nem a configuração de descontos (desconto, desconto máximo, tipo de desconto e permissão de desconto). Você pode organizar sua vitrine com calma: nenhuma carga do seu sistema vai desfazer isso.
• O nome do contato nunca é trocado. O nome que aparece na conversa é o nome que o WhatsApp ou a sua equipe registrou. Um cadastro do ERP com razão social ("MARIA SILVA COMÉRCIO LTDA") não substitui o nome pelo qual você conhece o cliente. Em contatos que já existem, a sincronização só preenche e-mail e documento quando esses campos ainda estão em branco.
• Nada é apagado. Produtos ou contatos que sumirem do seu sistema continuam existindo na Paralela. Para tirar um produto de circulação, envie-o como indisponível — ele deixa de ser oferecido na loja e pela IA, mas o cadastro e o histórico permanecem.

Reenvio e segurança do lote

• Reenviar o mesmo lote é seguro. Nada é duplicado: itens que já estão iguais são apenas ignorados.
• Cada lote aceita até 500 itens. Envios maiores devem ser divididos.
• Se um item específico falhar (por exemplo, um produto sem preço), os demais continuam sendo gravados. A resposta informa quantos itens foram criados, atualizados e ignorados, e lista o motivo de cada falha pelo identificador do seu sistema.
• Se o mesmo SKU (ou o mesmo telefone) vier duas vezes no mesmo lote, apenas a primeira ocorrência é gravada e a segunda é reportada como repetida.

---

Vozes (ElevenLabs)

O que é

A integração com a ElevenLabs permite que os assistentes de IA da Paralela respondam com áudio em vez de texto. Você pode criar vozes personalizadas a partir de amostras de áudio, ajustando características como velocidade, estabilidade e expressividade.

Passo a passo

1. Acessar as configurações de vozes

1. Abra Vozes no menu lateral. Se o item não aparece, abra Configurações Avançadas e, em Itens Ocultos do Menu, clique em Vozes para mostrá-lo no menu (ou procure "Vozes" na lupa do topo).
2. Você verá a lista de vozes disponíveis e a opção de criar novas.

2. Fazer upload de amostras de áudio

1. Clique no botão para criar uma nova voz.
2. Envie uma ou mais amostras de áudio da voz desejada.
3. Quanto melhor a qualidade e maior a variedade das amostras, mais fiel será a voz gerada.

Dicas para boas amostras:

• Use áudio limpo, sem música de fundo ou ruído.
• Inclua amostras com diferentes entonações (pergunta, afirmação, cumprimento).
• Duração ideal: entre 30 segundos e 2 minutos por amostra.
• Formato: MP3 ou WAV.

3. Ajustar parâmetros

Após enviar as amostras, ajuste os parâmetros para controlar como a voz soa:

Parâmetro	O que controla	Valor baixo	Valor alto	Recomendação
Estabilidade	Consistência entre gerações	Voz mais variada e expressiva, pode soar instável	Voz mais uniforme e previsível	Comece em 50-70% para atendimento. Aumente se a voz parecer inconsistente
Velocidade	Ritmo da fala	Fala mais lenta	Fala mais rápida	Mantenha próximo ao padrão. Ajuste se o áudio parecer apressado ou arrastado
Similaridade	Fidelidade a amostra original	Voz mais genérica	Voz mais próxima da amostra	Use valores altos (70-90%) para reproduzir fielmente a voz da amostra
Exagero de estilo	Expressividade	Fala mais neutra	Fala mais dramática	Mantenha baixo (20-40%) para atendimento profissional
Boost de speaker	Identidade vocal	Menos ênfase na identidade	Mais ênfase na identidade	Use valores médios (40-60%). Valores muito altos podem causar artefatos
Remoção de ruído	Filtragem de ruído das amostras	Menos filtragem	Mais filtragem	Ative se suas amostras tiverem ruído de fundo. Desative se o áudio já for limpo

Como ajustar na prática:

1. Comece com os valores padrão.
2. Gere um áudio de teste.
3. Ouça e identifique o que precisa mudar.
4. Ajuste um parâmetro por vez e teste novamente.

4. Vincular a voz a um assistente de IA

1. Acesse a configuração do assistente de IA desejado (menu Assistentes de IA ou Prompts).
2. No campo de voz, selecione a voz que você criou.
3. Salve as configurações do assistente.

Após vinculada, quando o assistente gerar uma resposta, o texto será automaticamente convertido em áudio usando a voz selecionada e enviado ao contato como mensagem de voz.

Observações:

• A conversão de texto em áudio adiciona um pequeno tempo de processamento a resposta.
• Mensagens muito longas podem resultar em áudios extensos. Considere configurar o assistente para dar respostas concisas.
• O uso de vozes consome créditos da ElevenLabs conforme o volume de caracteres convertidos.

---

Fila de Saída das Integrações

O que é

Quando sua empresa conectou um sistema de gestão e ligou a chave Pedidos, cada pedido criado na Paralela precisa chegar lá. A fila de saída é onde você acompanha essas entregas.

Cada linha da fila é uma entrega. Ela é registrada no mesmo instante em que o pedido é criado e permanece na fila até ser entregue ao seu sistema. Se o outro sistema estiver fora do ar, a entrega espera e é tentada de novo sozinha — nada se perde no caminho.

Para acessar, vá em Configurações > Integrações e role até a seção Fila de saída das integrações. A seção só aparece para usuários com permissão de gerenciar as configurações da empresa.

Os cinco status

Status	O que significa	Precisa de você?
Pendente	Aguardando a próxima tentativa de envio	Não
Enviando	A entrega está acontecendo agora	Não
Entregue	O seu sistema recebeu e confirmou	Não
Falhou	A tentativa não deu certo, mas ainda restam tentativas automáticas	Não
Não entregue	Todas as tentativas se esgotaram e a entrega parou	Sim

As tentativas automáticas são espaçadas: a primeira acontece em segundos e as seguintes vão ficando mais distantes, até cerca de uma hora. No total são oito tentativas ao longo de aproximadamente uma hora.

Por que "Não entregue" exige ação

Uma entrega nesse estado não sai da fila sozinha. Ela esgotou as tentativas automáticas e o registro nunca chegou ao seu sistema de gestão — na prática, o pedido existe na Paralela e não existe do outro lado.

O painel mostra um aviso no topo com a quantidade de entregas nessa situação. Depois de resolver a causa (o sistema voltou ao ar, a credencial foi corrigida, o cadastro que faltava foi criado), use o botão de reenviar.

Reenviar

Há duas formas:

• Uma entrega: use o botão de reenviar na própria linha.
• Em lote: use o botão Reenviar em lote e escolha o conjunto — apenas as que falharam, apenas as não entregues, ou as duas de uma vez. O rótulo de cada opção mostra quantas entregas ela alcança.

Reenviar devolve a entrega para a fila com o contador de tentativas zerado.

Entregas sem resposta conclusiva

Alguns casos aparecem com a marca Precisa de conciliação. Isso acontece quando a entrega saiu da Paralela mas a resposta do seu sistema não chegou — uma queda de conexão no meio do envio, por exemplo. Nessa situação não dá para saber se o registro foi criado do outro lado ou não.

Essas entregas não podem ser reenviadas pelo painel, e isso é proposital: a maioria dos sistemas de gestão não reconhece um envio repetido, então reenviar às cegas criaria um pedido duplicado no seu sistema.

Na maioria das vezes você não precisa fazer nada. Todo pedido que a Paralela envia leva um código próprio escrito na observação dele. Alguns minutos depois de uma entrega ficar sem resposta, a Paralela procura esse código na lista de pedidos do seu sistema — sem enviar nada de novo — e resolve sozinha:

• achou o código: o pedido existe no seu sistema. A entrega passa a Entregue, com o número que o seu sistema deu a ele;
• não achou, e a busca cobre com folga o momento do envio: o pedido não chegou. A entrega volta para a fila e é enviada de novo, uma vez só;
• qualquer dúvida — a busca não alcança o momento do envio, o seu sistema não respondeu, a conferência demorou demais: a Paralela não decide e a entrega continua na tela esperando você. Na dúvida ela prefere te perguntar a arriscar um pedido em dobro.

Quando a marca continuar na tela, é a sua vez:

1. Abra o seu sistema de gestão e verifique se o pedido ou agendamento foi mesmo criado.
2. Se foi criado, nada precisa ser feito — a entrega cumpriu o objetivo.
3. Se não foi criado, fale com o suporte para liberar o reenvio dessa entrega.

Agendamentos não são conferidos sozinhos: a conferência automática só existe para pedidos, porque é a lista de pedidos que os sistemas de gestão publicam.

Observações

• A coluna Último erro mostra a mensagem técnica devolvida pelo seu sistema. Ela ajuda o suporte a identificar a causa rapidamente.
• Entregas concluídas com sucesso saem da lista automaticamente depois de 30 dias. Entregas não entregues permanecem até serem resolvidas.
• Se a sua empresa ainda não tem uma integração configurada, a fila aparece vazia.
• Enquanto a chave Pedidos estiver desligada, nada entra na fila: nenhum pedido seu vai para o sistema de gestão.