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.

Existem tres formas principais de integracao:

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

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
Novo pedido	Um pedido e criado	Dados do pedido
Mudanca de agendamento	Um agendamento e 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

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. Voce vera a lista de tokens de API configurados.

2. Criar uma chave de API (token)

1. Clique no botao para adicionar uma nova chave.
2. O token e gerado automaticamente e vinculado a uma conexao WhatsApp.
3. Copie o token gerado imediatamente.

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)
queueId	number	ID da fila para direcionar a conversa
userId	number	ID do atendente para atribuir a conversa
closeTicket	boolean	Fecha o ticket apos envio
ignoreTicket	boolean	Envia sem criar ou reabrir ticket

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	Sucesso
400	Dados invalidos ou campo obrigatorio ausente
401	Token nao informado
403	Token invalido
404	Recurso 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

---

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.