Integracoes

Visao Geral

A Paralela permite conectar sua operacao com outros sistemas e ferramentas que voce ja utiliza. Com as integracoes, informacoes fluem automaticamente entre plataformas, eliminando trabalho manual e garantindo que seus processos estejam sempre atualizados.

As principais formas de integracao sao:

Tipo	O que faz
Webhooks de saida	A Paralela avisa um sistema externo quando algo acontece
Webhooks de entrada	Um sistema externo envia dados para a Paralela
API de Mensagens	Voce 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 gestao	Voce conecta o seu ERP na tela de configuracoes e a Paralela busca os produtos sozinha, reconhece os seus clientes e pode lembrar de boletos em aberto
Sincronizacao com sistema proprio	Seu ERP ou sistema de gestao envia produtos e contatos para a Paralela
Fila de saida	Pedidos e agendamentos criados na Paralela seguem para o seu sistema de gestao

Alem disso, a plataforma oferece integracao com o servico de vozes ElevenLabs para respostas em audio dos assistentes de IA.

---

Webhooks de Saida

O que sao

Um webhook de saida funciona como uma notificacao automatica. Toda vez que algo relevante acontece na Paralela (uma nova conversa, uma mensagem recebida, etc.), a plataforma envia essa informacao para um endereco que voce configurar. Pense nisso como um aviso: "algo aconteceu, aqui estao os detalhes".

Passo a passo

1. Acessar a pagina de Webhooks

No menu lateral, clique em Webhooks. Voce vera a lista de todos os webhooks configurados na sua conta, tanto de saida quanto de entrada.

2. Criar um novo webhook de saida

1. Clique no botao Adicionar no canto superior da pagina.
2. Na janela que abrir, preencha os campos de configuracao conforme a tabela abaixo.
3. Clique em Salvar.

3. Preencher os campos de configuracao

Campo	Descricao	Exemplo
Nome	Identificacao interna do webhook	"Sync CRM Vendas"
URL de destino	Endereco completo (incluindo https://) para onde a Paralela enviara os dados	https://meucrm.com/api/webhook
Metodo HTTP	Tipo de requisicao HTTP utilizada no envio	POST, GET, PUT, DELETE
Acao	Define o comportamento: chamar o webhook externo ou disparar um fluxo interno	Webhook ou Fluxo
Autenticacao HMAC	Chave secreta opcional. A Paralela assina cada requisicao com essa chave, permitindo ao sistema receptor validar que os dados sao autenticos	Qualquer string secreta

Sobre a acao "Fluxo": quando selecionada, em vez de enviar dados para uma URL externa, o evento dispara um fluxo de automacao dentro da Paralela. Util para criar automacoes internas sem precisar de um sistema externo.

Sobre autenticacao HMAC: o sistema receptor pode usar a chave secreta para verificar a assinatura da requisicao e confirmar que os dados vieram da Paralela, nao 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 incluidos
Nova conversa	Um ticket e criado	ID do ticket, contato, fila, canal
Nova mensagem	Uma mensagem e recebida	Conteudo da mensagem, contato, ticket
Novo contato	Um contato e criado	Nome, numero, dados do contato
Ticket transferido	Um ticket e 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 e 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 e criado	Dados do pedido
Pagamento recebido	O pagamento de um pedido e confirmado	Pedido, valor, meio de pagamento
Status de entrega alterado	O fulfillment de um pedido muda	Pedido, status anterior e novo
Novo agendamento / Mudanca de agendamento	Um agendamento e criado ou alterado	Dados do agendamento
Status da conexao	Uma conexao 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 nao respondeu dentro do prazo	Ticket, tempo de espera

Gatilhos de agendamento e de contato: a conexao

Ao configurar um gatilho de agendamento (novo agendamento, mudanca de agendamento, lembretes) ou de novo contato num fluxo, a conexao selecionada define por qual conexao o fluxo sera executado (por exemplo, de qual numero as notificacoes serao enviadas). Ela nao restringe quais eventos disparam o fluxo: um agendamento ou contato nao pertence a uma conexao especifica, entao o gatilho dispara para qualquer agendamento/contato criado na empresa — inclusive os que a I.A. cria durante conversas em outras conexoes.

5. Testar o webhook

1. Apos salvar, localize o webhook na lista.
2. Clique no botao de teste (icone de envio) na coluna de acoes.
3. A Paralela envia uma requisicao 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 esta acessivel pela internet (nao pode ser localhost).
• O metodo HTTP esta correto.
• O sistema receptor aceita requisicoes da Paralela (verifique firewalls e CORS).

6. Verificar logs de requisicao

1. Clique no webhook desejado para abrir os detalhes.
2. Consulte o historico de envios nos logs de requisicao.
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 integracao.

Casos de uso

Cenario	Como configurar
Sincronizar contatos com CRM	Crie um webhook de saida com evento "Novo contato" apontando para a API do seu CRM
Registrar conversas em planilha	Use evento "Nova conversa" com URL de um servico 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 supervisao

---

Webhooks de Entrada

O que sao

Um webhook de entrada funciona no sentido oposto: um sistema externo envia dados para a Paralela. A plataforma gera uma URL unica que voce configura no outro sistema como destino. Quando esse sistema envia informacoes para a URL, a Paralela recebe e processa os dados.

Passo a passo

1. Criar um webhook de entrada

1. No menu lateral, clique em Webhooks.
2. Clique no botao Adicionar.
3. Selecione o tipo Entrada.
4. Preencha o nome de identificacao do webhook.
5. Clique em Salvar.

A Paralela gera automaticamente uma URL unica e um token de autenticacao para este webhook.

2. Copiar a URL unica

1. Apos criar, localize o webhook de entrada na lista.
2. Clique no botao de copiar ao lado da URL.
3. A URL segue o formato: https://sua-instancia.paralela.com.br/incoming-webhook/{token}

Essa URL e exclusiva deste webhook. Qualquer requisicao enviada para ela sera processada pela Paralela.

3. Configurar a URL no sistema externo

No sistema que vai enviar dados para a Paralela:

1. Localize a secao de webhooks, notificacoes ou integracoes.
2. Cole a URL copiada como destino.
3. Configure o formato de envio como JSON.
4. Ative o webhook no sistema externo.

4. Configurar seguranca

Opcao	Descricao	Quando usar
Token de autenticacao	Token unico gerado automaticamente. O sistema externo deve inclui-lo na URL para validar a origem da requisicao	Sempre ativo por padrao. A URL ja contem o token
Validacao 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 voce precisa de seguranca adicional

Como funciona a validacao 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 requisicao usando a chave.
4. A Paralela verifica a assinatura antes de processar os dados.

5. Metodos HTTP aceitos

Metodo	Uso tipico
GET	Consultas simples, dados via query string
POST	Envio de dados no corpo da requisicao (mais comum)
PUT	Atualizacao de dados
DELETE	Sinalizacao de remocao

Por padrao, apenas o metodo POST e aceito. Voce pode habilitar metodos adicionais na configuracao do webhook.

6. Limite de requisicoes

O webhook de entrada aceita ate 100 requisicoes por minuto por IP. Requisicoes que excedam esse limite recebem resposta HTTP 429 (Too Many Requests).

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

7. Configurar acoes ao receber dados

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

Acao	Descricao	Quando usar
Disparar um fluxo	Inicia um fluxo de automacao usando os dados recebidos como variaveis	Processar pagamentos, criar tickets, enviar mensagens automaticas
Disparar um webhook de saida	Encaminha os dados recebidos para outro sistema externo	Rotear dados entre sistemas, criar pipelines de integracao

Disparar um fluxo e a opcao mais comum. Os dados recebidos ficam disponiveis como variaveis dentro do fluxo, permitindo automacoes como:

• Enviar uma mensagem de confirmacao ao contato.
• Criar ou atualizar um ticket.
• Registrar informacoes em campos personalizados.

Identificacao do contato: voce pode configurar qual campo da requisicao contem o identificador do contato (telefone, email ou ID do contato). Isso permite que o fluxo disparado saiba para quem enviar mensagens.

Tipo de identificacao	Campo esperado	Exemplo
Telefone	Numero com DDI	5511999998888
Email	Endereco de email	cliente@email.com
ID do contato	ID interno da Paralela	12345

8. Verificar o log da ultima requisicao

1. Na lista de webhooks, localize o webhook de entrada.
2. Clique para abrir os detalhes.
3. A secao Ultima requisicao mostra:

Informacao	Descricao
Data/hora	Quando a requisicao foi recebida
Metodo HTTP	GET, POST, PUT ou DELETE
Headers	Cabecalhos enviados pelo sistema externo
Body	Corpo da requisicao (dados recebidos)
IP de origem	Endereco IP do sistema que enviou a requisicao
Status	Codigo de resposta retornado

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

Modo de teste: webhooks de entrada possuem um modo de teste que permite receber requisicoes e registrar os dados sem executar nenhuma acao. Util para validar o formato dos dados antes de conectar a um fluxo.

Exemplo pratico: recebendo notificacoes de pagamento

Cenario: uma plataforma de e-commerce envia uma notificacao quando um pagamento e confirmado. A Paralela recebe essa notificacao e envia uma mensagem de confirmacao ao cliente.

Configuracao:

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 notificacoes de pagamento.
4. Na Paralela, configure o campo de identificacao do contato como "telefone" e indique qual campo do payload contem o numero (ex: customer_phone).
5. Crie um fluxo de automacao 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 e

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

Passo a passo

1. Acessar a pagina de API

No menu lateral, clique em API de Mensagens. A pagina esta dividida em secoes: Comecando, Mensagens, Contatos, Atendimentos, Listas de apoio e Servidor MCP (IA).

2. Escolher a conexao e obter o token

Cada conexao de WhatsApp tem seu proprio token de API. No topo da pagina, o seletor Conexao usada nos exemplos define qual conexao a integracao vai usar:

1. Escolha a conexao no seletor.
2. Clique no icone de olho para revelar o token e no icone de copia para copia-lo.
3. Todos os exemplos e testes da pagina passam a usar essa conexao.

Se a conexao ainda nao tiver token, gere um em Conexoes → Editar → Token.

Importante: guarde o token em local seguro. Ele funciona como uma senha e da acesso ao envio de mensagens pela sua conta. Nao compartilhe em codigo-fonte publico, repositorios abertos ou mensagens nao criptografadas.

3. Usar o token nas chamadas de API

Inclua o token no cabecalho Authorization de todas as requisicoes:

Authorization: Bearer {seu-token-aqui}

Exemplo com cURL:

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

4. Endpoints disponiveis

Mensagens

Endpoint	Metodo	Descricao
/api/messages/send	POST	Envia mensagem de texto ou midia
/api/messages/send/linkImage	POST	Envia imagem a partir de uma URL

Enviar mensagem de texto:

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

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

Opcoes adicionais para envio:

Campo	Tipo	Descricao
number	string	Numero do destinatario com DDI (obrigatorio)
body	string	Texto da mensagem (obrigatorio)
whatsappId	number	Conexao que fara o envio. Sem isso, usa a conexao 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 apos envio
noRegister	boolean	Envia sem registrar a mensagem no historico
msdelay	number	Atraso em milissegundos antes do envio

A pagina 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 verificacao de numero — um formulario para testar a chamada na hora.

Contatos

Endpoint	Metodo	Descricao
/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 numero
/api/messages/contact/tag/sync	POST	Sincroniza tags de um contato

Tickets (conversas)

Endpoint	Metodo	Descricao
/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	Metodo	Descricao
/api/messages/checkNumber	POST	Verifica se um numero 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 conexoes WhatsApp

Leads

Endpoint	Metodo	Descricao
/api/messages/lead/create	POST	Cria um novo lead

5. Codigos de resposta

Codigo	Significado
200 / 201	Sucesso
400	Dados invalidos ou campo obrigatorio ausente (normalmente o numero fora do formato)
401	Token ausente ou invalido no cabecalho Authorization
403	Seu plano nao inclui o recurso de API externa
404	Contato, ticket ou conexao nao encontrado
500	Erro interno do servidor

6. Boas praticas

• Armazene o token com seguranca. Use variaveis de ambiente no seu sistema, nunca hardcode.
• Valide numeros antes de enviar. Use o endpoint /checkNumber para confirmar que o numero tem WhatsApp ativo.
• Trate erros. Sempre verifique o codigo de resposta e implemente retentativas para falhas temporarias (5xx).
• Respeite limites. Evite enviar rajadas de mensagens. Espacar envios reduz o risco de bloqueio pelo WhatsApp.
• Nao envie spam. Mensagens nao solicitadas violam os termos do WhatsApp e podem resultar em bloqueio da sua conexao.

7. Casos de uso

Cenario	Endpoints utilizados
Confirmacao 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
Pesquisa de satisfacao	/send apos fechamento do ticket + /ticket/close para finalizar
Importacao 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 e

O servidor MCP permite que clientes de IA externos (como o Claude Desktop, ou produtos proprios) operem a Paralela em linguagem natural, por meio do Model Context Protocol (MCP). Diferente da API de Mensagens — que e ideal para integracoes diretas e deterministicas —, o MCP e voltado para agentes que decidem quais acoes executar, cobrindo o mesmo conjunto de operacoes do Copilot: atendimentos, contatos, campanhas, fluxos, kanban, tarefas, agentes de IA, loja, relatorios e muito mais.

Como funciona

1. Um administrador cria um token MCP em API de Mensagens → Servidor MCP (IA) (a operacao exige permissao de administrador). O token e exibido uma unica vez, junto com a configuracao 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 acoes com as permissoes do usuario dono do token — acoes sensiveis exigem confirmacao em uma chamada seguinte, e o acesso pode ser revogado a qualquer momento excluindo o token.

A documentacao completa (endpoint, autenticacao, gestao de tokens e exemplo de configuracao para o Claude Desktop) esta em Servidor MCP.

---

Conectar o Seu Sistema de Gestao

O que e

Se a sua empresa ja controla produtos e clientes em um sistema de gestao (ERP, PDV, sistema de delivery), voce pode conectar esse sistema voce mesmo, direto na tela de configuracoes. Nao e 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 preco, estoque e disponibilidade sempre atualizados, sem cadastro em dobro.

Esta e a forma mais simples de manter os dois lados iguais. Se o seu sistema prefere enviar os dados em vez de ser consultado, a secao seguinte (Sincronizacao com Sistema Proprio) descreve esse outro caminho, que continua valendo.

Passo a passo

1. Abrir a tela

No menu lateral, clique em Configuracoes e escolha a secao Integracoes. Se voce nao ve essa secao, e porque o seu usuario nao tem a permissao de gerenciar as configuracoes da empresa — peca a um administrador.

2. Escolher o sistema

Em Sistemas disponiveis aparece um card para cada sistema de gestao que a Paralela sabe conectar. Clique em Conectar no card do seu.

3. Informar o acesso

A janela pede o mesmo usuario e a mesma senha que voce 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.
• Nao deu: a mensagem aparece dentro da propria janela, em portugues, e o que voce digitou continua la. O erro mais comum e usuario ou senha incorretos — confira digitando no proprio sistema antes de tentar de novo.

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

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

Se o seu acesso alcanca mais de uma loja, filial ou deposito, a janela pergunta qual e a sua e mostra a lista com os nomes que voce ja conhece do seu sistema. Escolha e clique em Conectar de novo.

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

O que voce ve depois de conectado

Item	O que significa
Status	Ativa (funcionando), Precisa de atencao (a ultima tentativa falhou, veja a mensagem no card) ou Pausada (voce parou a sincronizacao)
Ultima sincronizacao	Quando a Paralela buscou dados no seu sistema pela ultima vez
Mensagem de erro	O motivo da ultima falha, em portugues. Ela some sozinha quando uma sincronizacao der certo
Registros que ficaram de fora	Quantos cadastros do seu sistema a Paralela nao conseguiu ler — veja Quando um cadastro do seu sistema fica de fora
Chaves por recurso	Uma chave para cada tipo de dado. Voce decide o que a Paralela pode trazer
Sincronizar agora	Busca no seu sistema imediatamente, sem esperar a proxima rodada
Pausar / Retomar	Para tudo por um tempo, sem apagar nada. Veja Pausar sem desconectar
Atualizar acesso	Use quando a senha do seu sistema mudar. E o conserto do status Precisa de atencao
Desconectar	Apaga a senha do seu sistema e para a sincronizacao

Os recursos, um a um

Recurso	Sentido	O que faz	Como nasce
Produtos	Do seu sistema para a Paralela	Traz os produtos do seu sistema, com preco, estoque e disponibilidade	Ligado
Clientes	Do seu sistema para a Paralela	Reconhece, no seu sistema, quem esta falando com voce — veja abaixo	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 nao disponivel para nenhum sistema	—
Cobrancas	Do seu sistema para a Paralela	Traz os boletos em aberto, para consulta e para lembretes automaticos	Desligado

Os dois primeiros a Paralela busca; o terceiro ela envia. So o recurso Pedidos escreve algo dentro do seu sistema, e por isso ele merece uma leitura a parte — veja Enviar pedidos para o seu sistema.

Por que "Clientes" nasce desligado: ligar essa chave e voce autorizando a Paralela a olhar a sua base de clientes. Enquanto ela estiver desligada, a Paralela nao pergunta nada sobre os seus clientes ao seu sistema.

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

Nem todo sistema de gestao entrega a lista de clientes, e nem todo sistema precisa entregar. O texto no proprio card diz qual e o caso do seu.

O seu sistema	O que a chave Clientes faz	A sua base e copiada para a Paralela?
Sabe entregar a lista inteira	A Paralela traz os clientes cadastrados, de tempos em tempos	Sim
So sabe responder por telefone	Quando alguem chama, a Paralela pergunta ao seu sistema quem e o dono daquele numero	Nao

O segundo caso e o mais comum, e o KP Delivery e um deles: a tela de clientes dele e uma busca — voce digita um nome ou um telefone e ele responde —, nao uma listagem. Isso nao e uma limitacao do que a Paralela faz por voce: uma conversa de WhatsApp comeca justamente com um telefone, que e exatamente a pergunta que o seu sistema sabe responder.

Na pratica, com um sistema de consulta:

• o cliente manda mensagem e a Paralela pergunta ao seu sistema quem e o dono daquele numero;
• 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) sao preenchidos com o que ele ja tem la;
• nao achou: e um cliente novo, e a Paralela guarda que perguntou — ela nao fica perguntando de novo a cada mensagem;
• achou mais de um (linha compartilhada, casa com dois cadastros, loja e dono): a Paralela nao escolhe. Escolher errado mandaria a entrega para o endereco de outra pessoa, e nada pareceria errado ate a entrega chegar na porta errada. Quem sabe qual e o certo e voce.

Quando o telefone tem mais de um cadastro e sai um pedido, o pedido nao e lancado e aparece como Nao entregue na fila de saida, dizendo que ha mais de um cliente com aquele telefone. E de proposito: um pedido parado voce reenvia depois de acertar os cadastros no seu sistema; uma entrega no endereco errado nao tem desfazer.

A pergunta e feita quando uma conversa nova comeca — no maximo 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 proxima conversa dele. Disparo de campanha e importacao de historico nao consultam o seu sistema: a pergunta so vale quando ha alguem do outro lado conversando.

O que continua valendo nos dois casos: o nome do contato nunca e trocado pelo do seu sistema, e so campos vazios (e-mail e documento) sao preenchidos. Veja O que a sincronizacao NAO faz.

Por que "Pedidos" nasce desligado: e o unico recurso que cria registro dentro do seu sistema de gestao. Ele so passa a valer quando voce liga a chave, e a partir dali cada pedido fechado na Paralela vira um pedido la.

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 nao consegue interpretar: um boleto sem data de vencimento, um cliente sem nome, um produto com preco em branco. Nesses casos o card mostra quantos registros ficaram de fora.

O que voce precisa saber sobre esse aviso:

• A sincronizacao continua rodando. Os outros cadastros entram normalmente; so os que a Paralela nao conseguiu ler ficam de fora.
• Nada e apagado. O registro continua existindo no seu sistema, exatamente como esta.
• Ele volta sozinho. Assim que o cadastro for corrigido no seu sistema, a proxima rodada o traz e a contagem cai — voce nao precisa avisar ninguem nem clicar em nada.
• Contagem que nao cai por dias e o sinal de que o cadastro precisa de um ajuste la: o campo que falta e sempre um campo obrigatorio para o proprio sistema de gestao.

Se voce nao souber quais sao 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 e o unico que escreve no seu sistema de gestao. Ligue a chave Pedidos no card da integracao e, a partir daquele instante, cada pedido fechado na Paralela e enviado para o seu sistema automaticamente. Pedidos fechados antes de voce ligar a chave nao sao enviados.

O que acontece a cada pedido:

1. o pedido entra na fila de saida no mesmo instante em que e criado na Paralela;
2. a Paralela o envia ao seu sistema, com o mesmo usuario e a mesma senha que voce informou ao conectar;
3. quando o seu sistema confirma, a entrega aparece como Entregue e guarda o numero que ele devolveu.

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

Situacao	O que voce ve	O que fazer
O seu sistema estava fora do ar	A entrega e tentada de novo sozinha	Nada
O seu sistema recusou o pedido (falta um dado, por exemplo)	Nao 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 atencao	Use Atualizar acesso e depois Reenviar as entregas paradas
A resposta do seu sistema nao chegou	Precisa de conciliacao — por pouco tempo, na maioria dos casos	Normalmente nada: a Paralela confere sozinha. Veja Entregas sem resposta conclusiva

Um pedido nunca e enviado duas vezes por conta propria. Quando a Paralela nao 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 nao tem desfazer.

Para parar de enviar, desligue a chave Pedidos. As entregas que ja estao na fila seguem o desfecho delas; nenhum pedido novo entra — e os pedidos fechados com a chave desligada nao sao enviados depois. Se o que voce quer e parar tudo por um tempo — porque esta mexendo no seu sistema, por exemplo —, use Pausar: ali nada e perdido, os pedidos entram na fila e esperam ate voce retomar.

Com que frequencia acontece

• Produtos: a cada 15 minutos, aproximadamente.
• Clientes, quando o seu sistema entrega a lista: a cada hora, aproximadamente.
• Clientes, quando o seu sistema so responde por telefone: quando o cliente chama, e no maximo uma vez por dia para cada contato. Campanha e importacao de historico nao contam.
• Pedidos: na hora — cada pedido e enviado assim que e fechado na Paralela.

A primeira busca comeca poucos minutos depois de voce conectar. Nao e preciso ficar na tela esperando.

Em sistemas com muitos cadastros, cada rodada le varios lotes seguidos em vez de um so — entao a primeira volta completa pela sua base leva minutos, e nao horas. Depois disso, o que muda no seu sistema aparece aqui na frequencia da tabela acima.

O que a Paralela nao faz com os seus dados

Vale exatamente o mesmo que esta descrito em O que a sincronizacao NAO faz: a sua vitrine, as suas fotos, os seus descontos e os nomes dos seus contatos ficam como voce deixou. Nada e apagado.

Pausar sem desconectar

Pausar para tudo por um tempo e nao apaga nada. E o botao para quando voce esta arrumando o catalogo no seu sistema, ou quando o preco de la esta errado e voce nao quer que ele desca 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 saida e esperam la, junto com os que ja estavam. Nenhum e enviado e nenhum e perdido: todos saem quando voce retomar, e todos ficam visiveis na fila enquanto isso;
• a senha do seu sistema continua guardada, e as chaves dos recursos ficam como voce as deixou;
• Sincronizar agora avisa que a sincronizacao esta pausada, em vez de buscar.

Retomar e um clique no mesmo lugar. Nao ha o que redigitar: a integracao volta para o mesmo estado em que estava — inclusive Precisa de atencao, se era esse o caso quando voce pausou.

Pausar nao pede confirmacao, porque e reversivel. Desconectar pede, porque nao e.

Voce 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 botao Desconectar pede confirmacao e, ao confirmar:

• a senha do seu sistema e apagada do nosso banco;
• a sincronizacao para;
• os produtos e contatos que ja entraram continuam aqui, como qualquer cadastro seu;
• a fila de saida continua na tela enquanto houver entrega pendente, morta ou esperando conciliacao. Desconectar nao apaga o que ficou para tras, e voce continua podendo conferir e resolver cada linha.

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

Trocar a senha de uma integracao pausada nao a retoma: use Atualizar acesso para corrigir o acesso e Retomar quando quiser que ela volte a funcionar.

---

Cobrancas e lembretes automaticos

Disponivel nos sistemas de gestao que trabalham com boleto. Ligando a chave Cobrancas, a Paralela passa a trazer para ca os boletos em aberto dos seus clientes — valor, vencimento, link da segunda via, linha digitavel e Pix.

Isso serve para duas coisas:

1. Responder quem pergunta. O cliente escreve "quero minha segunda via" e a IA responde com as cobrancas dele, sem ninguem da sua equipe procurar nada. Precisa estar ligada tambem 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 voce definir.

Nada e enviado ate voce mandar. A chave nasce desligada e, mesmo depois de ligada, a regua de lembretes nasce em modo simulacao: ela faz a conta inteira e nao envia nada. Voce ve o numero antes de qualquer mensagem sair.

A regua de lembretes

A regua aparece dentro do proprio card do sistema conectado, logo abaixo das chaves, assim que voce liga Cobrancas.

Campo	O que faz
Enviar lembretes automaticamente	A chave geral. Desligada, nada roda
Modo simulacao	Ligado, a Paralela calcula tudo e nao envia nada. Nasce ligado
Enviar pela conexao	De qual dos seus numeros as cobrancas saem. Sem escolher, nada e enviado
Dias do lembrete	Quando avisar, em dias em relacao ao vencimento. Negativo e antes, positivo e depois. Ex.: -3, 7 avisa tres dias antes de vencer e sete dias depois
A partir das / Ate as	A janela de horario. Fora dela a Paralela nao envia — e nao acumula para mandar tudo junto quando abrir
Dias da semana	Em quais dias os lembretes podem sair
Nao cobrar apos (dias)	Divida mais velha que isso e ignorada. Padrao: 90 dias
Maximo por ciclo / por dia	Tetos de quantas mensagens saem de uma vez e por dia. O que sobra entra na proxima rodada
Texto da mensagem	Vazio usa o texto padrao. Aceita variaveis — veja abaixo

Simular antes de ligar

O botao Simular agora roda a selecao inteira sem enviar nada e responde, por exemplo:

Seriam 96 mensagens para 96 associados. 46 ficam para os proximos ciclos. 166 sem celular valido, fora do envio.

Esses tres numeros sao o que voce precisa antes de decidir: quantas mensagens saem, quantas ficam para depois, e quantos clientes voce nao alcanca porque nao ha celular no cadastro deles. Simule quantas vezes quiser — simular nunca envia.

Quando voce desliga o modo simulacao, a Paralela pergunta uma vez, dizendo quantas mensagens a ultima simulacao apontou e por qual numero elas sairao.

O texto da mensagem

Deixando o campo vazio, a Paralela monta um texto que comeca pelo nome de quem deve e termina avisando para desconsiderar se ja pagou. As duas coisas sao de proposito: telefone de recepcao e celular compartilhado existem, e um pagamento feito hoje de manha no banco pode ainda nao ter chegado aqui.

Escrevendo o seu proprio texto, use estas variaveis entre chaves duplas:

Variavel	O que vira
nome	Nome de quem deve
valor	Total das cobrancas 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 digitavel do boleto
pix	Pix copia e cola

O que a Paralela nunca faz

• Nao manda duas vezes o mesmo aviso. Cada degrau da regua sai uma vez por cliente, por cobranca. Se a sincronizacao rodar dez vezes no dia, o cliente recebe uma mensagem
• Nao junta varias mensagens para a mesma pessoa. Quem deve tres boletos recebe uma mensagem com os tres
• Nao cobra quem nao deve. Boleto pago ou cancelado no seu sistema sai da lista sozinho
• Nao envia para quem nao tem celular no cadastro. Esses clientes aparecem no numero da simulacao, para voce saber quantos sao
• Nao envia fora da janela que voce definiu, e nao guarda para mandar tudo assim que ela abrir

Um cuidado que vale saber: a Paralela le o seu sistema de tempos em tempos, entao um boleto pago agora ha pouco pode levar algumas horas para sumir daqui. E por isso que o texto padrao termina com "se voce ja pagou, desconsidere" — e por isso que o primeiro aviso depois do vencimento nao sai no dia seguinte.

---

Sincronizacao com Sistema Proprio

O que e

Se a sua empresa ja controla produtos e clientes em um sistema proprio (ERP, PDV, sistema de gestao), a sincronizacao evita o cadastro em dobro. Um intermediario chamado Paralela Connect le os dados do seu sistema e os envia para a Paralela em lotes, de forma automatica e periodica.

O sentido do fluxo e sempre do seu sistema para a Paralela. A Paralela nao altera nada no seu ERP.

Como ativar

1. Um administrador cria um token de sincronizacao (a operacao exige permissao de administrador). O token e exibido uma unica vez — copie e guarde no momento da criacao.
2. Esse token e 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 e o indicado quando o seu sistema envia os dados. Se voce prefere que a Paralela busque os dados sozinha, sem token e sem configuracao externa, veja Conectar o Seu Sistema de Gestao.

O que a sincronizacao faz

Dado	Como e identificado	O que acontece
Produtos	Pelo SKU dentro da sua empresa	Se o SKU ainda nao existe, o produto e criado. Se ja existe, ele e atualizado
Contatos	Pelo numero de telefone dentro da sua empresa	Se o numero ainda nao existe, o contato e criado. Se ja existe, apenas campos vazios sao preenchidos

Nos produtos, a sincronizacao mantem atualizados: titulo, preco, descricao, categoria, estoque e disponibilidade.

O que a sincronizacao NAO faz

Esta e a parte mais importante: o trabalho que voce fez dentro da Paralela nao e sobrescrito.

• A loja virtual e preservada. A sincronizacao nunca altera se o produto esta publicado na loja, a ordem em que ele aparece, as fotos, as palavras-chave nem a configuracao de descontos (desconto, desconto maximo, tipo de desconto e permissao de desconto). Voce pode organizar sua vitrine com calma: nenhuma carga do seu sistema vai desfazer isso.
• O nome do contato nunca e trocado. O nome que aparece na conversa e o nome que o WhatsApp ou a sua equipe registrou. Um cadastro do ERP com razao social ("MARIA SILVA COMERCIO LTDA") nao substitui o nome pelo qual voce conhece o cliente. Em contatos que ja existem, a sincronizacao so preenche e-mail e documento quando esses campos ainda estao em branco.
• Nada e apagado. Produtos ou contatos que sumirem do seu sistema continuam existindo na Paralela. Para tirar um produto de circulacao, envie-o como indisponivel — ele deixa de ser oferecido na loja e pela IA, mas o cadastro e o historico permanecem.

Reenvio e seguranca do lote

• Reenviar o mesmo lote e seguro. Nada e duplicado: itens que ja estao iguais sao apenas ignorados.
• Cada lote aceita ate 500 itens. Envios maiores devem ser divididos.
• Se um item especifico falhar (por exemplo, um produto sem preco), 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 ocorrencia e gravada e a segunda e reportada como repetida.

---

Vozes (ElevenLabs)

O que e

A integracao com a ElevenLabs permite que os assistentes de IA da Paralela respondam com audio em vez de texto. Voce pode criar vozes personalizadas a partir de amostras de audio, ajustando caracteristicas como velocidade, estabilidade e expressividade.

Passo a passo

1. Acessar as configuracoes de vozes

1. No menu lateral, acesse Configuracoes ou a area de Assistentes de IA.
2. Localize a secao de Vozes ou ElevenLabs.
3. Voce vera a lista de vozes disponiveis e a opcao de criar novas.

2. Fazer upload de amostras de audio

1. Clique no botao para criar uma nova voz.
2. Envie uma ou mais amostras de audio da voz desejada.
3. Quanto melhor a qualidade e maior a variedade das amostras, mais fiel sera a voz gerada.

Dicas para boas amostras:

• Use audio limpo, sem musica de fundo ou ruido.
• Inclua amostras com diferentes entonacoes (pergunta, afirmacao, cumprimento).
• Duracao ideal: entre 30 segundos e 2 minutos por amostra.
• Formato: MP3 ou WAV.

3. Ajustar parametros

Apos enviar as amostras, ajuste os parametros para controlar como a voz soa:

Parametro	O que controla	Valor baixo	Valor alto	Recomendacao
Estabilidade	Consistencia entre geracoes	Voz mais variada e expressiva, pode soar instavel	Voz mais uniforme e previsivel	Comece em 50-70% para atendimento. Aumente se a voz parecer inconsistente
Velocidade	Ritmo da fala	Fala mais lenta	Fala mais rapida	Mantenha proximo ao padrao. Ajuste se o audio parecer apressado ou arrastado
Similaridade	Fidelidade a amostra original	Voz mais generica	Voz mais proxima da amostra	Use valores altos (70-90%) para reproduzir fielmente a voz da amostra
Exagero de estilo	Expressividade	Fala mais neutra	Fala mais dramatica	Mantenha baixo (20-40%) para atendimento profissional
Boost de speaker	Identidade vocal	Menos enfase na identidade	Mais enfase na identidade	Use valores medios (40-60%). Valores muito altos podem causar artefatos
Remocao de ruido	Filtragem de ruido das amostras	Menos filtragem	Mais filtragem	Ative se suas amostras tiverem ruido de fundo. Desative se o audio ja for limpo

Como ajustar na pratica:

1. Comece com os valores padrao.
2. Gere um audio de teste.
3. Ouca e identifique o que precisa mudar.
4. Ajuste um parametro por vez e teste novamente.

4. Vincular a voz a um assistente de IA

1. Acesse a configuracao do assistente de IA desejado (menu Assistentes de IA ou Prompts).
2. No campo de voz, selecione a voz que voce criou.
3. Salve as configuracoes do assistente.

Apos vinculada, quando o assistente gerar uma resposta, o texto sera automaticamente convertido em audio usando a voz selecionada e enviado ao contato como mensagem de voz.

Observacoes:

• A conversao de texto em audio adiciona um pequeno tempo de processamento a resposta.
• Mensagens muito longas podem resultar em audios extensos. Considere configurar o assistente para dar respostas concisas.
• O uso de vozes consome creditos da ElevenLabs conforme o volume de caracteres convertidos.

---

Fila de Saida das Integracoes

O que e

Quando sua empresa conectou um sistema de gestao e ligou a chave Pedidos, cada pedido criado na Paralela precisa chegar la. A fila de saida e onde voce acompanha essas entregas.

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

Para acessar, va em Configuracoes > Integracoes e role ate a secao Fila de saida das integracoes. A secao so aparece para usuarios com permissao de gerenciar as configuracoes da empresa.

Os cinco status

Status	O que significa	Precisa de voce?
Pendente	Aguardando a proxima tentativa de envio	Nao
Enviando	A entrega esta acontecendo agora	Nao
Entregue	O seu sistema recebeu e confirmou	Nao
Falhou	A tentativa nao deu certo, mas ainda restam tentativas automaticas	Nao
Nao entregue	Todas as tentativas se esgotaram e a entrega parou	Sim

As tentativas automaticas sao espacadas: a primeira acontece em segundos e as seguintes vao ficando mais distantes, ate cerca de uma hora. No total sao oito tentativas ao longo de aproximadamente uma hora.

Por que "Nao entregue" exige acao

Uma entrega nesse estado nao sai da fila sozinha. Ela esgotou as tentativas automaticas e o registro nunca chegou ao seu sistema de gestao — na pratica, o pedido existe na Paralela e nao existe do outro lado.

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

Reenviar

Ha duas formas:

• Uma entrega: use o botao de reenviar na propria linha.
• Em lote: use o botao Reenviar em lote e escolha o conjunto — apenas as que falharam, apenas as nao entregues, ou as duas de uma vez. O rotulo de cada opcao mostra quantas entregas ela alcanca.

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 conciliacao. Isso acontece quando a entrega saiu da Paralela mas a resposta do seu sistema nao chegou — uma queda de conexao no meio do envio, por exemplo. Nessa situacao nao da para saber se o registro foi criado do outro lado ou nao.

Essas entregas nao podem ser reenviadas pelo painel, e isso e proposital: a maioria dos sistemas de gestao nao reconhece um envio repetido, entao reenviar as cegas criaria um pedido duplicado no seu sistema.

Na maioria das vezes voce nao precisa fazer nada. Todo pedido que a Paralela envia leva um codigo proprio escrito na observacao dele. Alguns minutos depois de uma entrega ficar sem resposta, a Paralela procura esse codigo na lista de pedidos do seu sistema — sem enviar nada de novo — e resolve sozinha:

• achou o codigo: o pedido existe no seu sistema. A entrega passa a Entregue, com o numero que o seu sistema deu a ele;
• nao achou, e a busca cobre com folga o momento do envio: o pedido nao chegou. A entrega volta para a fila e e enviada de novo, uma vez so;
• qualquer duvida — a busca nao alcanca o momento do envio, o seu sistema nao respondeu, a conferencia demorou demais: a Paralela nao decide e a entrega continua na tela esperando voce. Na duvida ela prefere te perguntar a arriscar um pedido em dobro.

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

1. Abra o seu sistema de gestao 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 nao foi criado, fale com o suporte para liberar o reenvio dessa entrega.

Agendamentos nao sao conferidos sozinhos: a conferencia automatica so existe para pedidos, porque e a lista de pedidos que os sistemas de gestao publicam.

Observacoes

• A coluna Ultimo erro mostra a mensagem tecnica devolvida pelo seu sistema. Ela ajuda o suporte a identificar a causa rapidamente.
• Entregas concluidas com sucesso saem da lista automaticamente depois de 30 dias. Entregas nao entregues permanecem ate serem resolvidas.
• Se a sua empresa ainda nao tem uma integracao configurada, a fila aparece vazia.
• Enquanto a chave Pedidos estiver desligada, nada entra na fila: nenhum pedido seu vai para o sistema de gestao.