FireZAP Central de Ajuda
SiteEntrar
Central de Ajuda
Já sou assinante

Canal espelho: trazer para cá conversas de outro sistema

Uma cópia somente leitura das conversas de um bot que já é atendido por outro sistema — para o histórico ficar no FireZAP, pesquisável.

Às vezes o bot já existe e já é atendido por outro sistema — um gateway próprio, uma automação, um atendimento interno. O Telegram aceita UM consumidor por bot: conectá-lo aqui do jeito normal derrubaria o outro sistema, ou teria o próprio canal derrubado por ele. O canal espelho resolve isso sem disputa: ele nunca fala com o Telegram. O outro sistema é que empurra cada mensagem para o FireZAP, e aqui ela vira conversa, com histórico, busca e relatório.

Como criar

  1. 1Conexão → Adicionar canal → Telegram (espelho).
  2. 2Dê um nome ao canal. O @username e o ID do bot são opcionais e servem só de rótulo — nada é consultado no Telegram.
  3. 3Escolha onde as conversas espelhadas vão cair: Abertos, Pendentes ou Finalizados.
  4. 4Depois de criar, vá em Equipe e marque o canal para quem precisa vê-lo. Atendente não enxerga conversa de canal que não está vinculado a ele; dono e administrador veem sempre.
  5. 5Em Conexão → Configurar, na caixa Dados para quem envia o espelho, copie a URL, o canal_id e o token — ou use Copiar tudo com as instruções, que monta o texto pronto — e entregue ao responsável pelo outro sistema. O token sai preso a este canal: com ele não dá para enviar mensagem nem escrever em outra conexão.

Onde as conversas caem

Abertos
A equipe acompanha a conversa acontecendo, na fila de atendimento. É o padrão, e o caso de quem quer olhar o que o bot está respondendo.
Pendentes
A conversa entra na fila como quem espera atendimento. Use quando alguém da equipe precisa assumir o que o bot começou.
Finalizados
Só histórico: a conversa não aparece na fila e não abre protocolo. Use quando o outro sistema já resolve tudo sozinho e você quer apenas o registro.

A escolha vale para as próximas conversas — as que já estão gravadas continuam onde estão. Dá para mudar quando quiser em Conexão → Configurar.

O que este canal NÃO faz

  • Não envia mensagem: a caixa de resposta fica travada, e para responder você usa o Telegram. A nota interna continua funcionando.
  • Não aparece em Disparos, Campanhas, Agenda nem em Iniciar conversa.
  • Não é atendido pelo agente de IA, nem por fluxo ou automação: quem responde é o outro sistema.
  • Não tem menu de recepção, resposta em áudio nem encerramento por inatividade.
  • Nesta primeira versão só recebe texto. Foto, áudio e documento chegam como descrição ([imagem], [áudio]).
Não consome o seu plano

Canal espelho não ocupa vaga de conexão, e as conversas e mensagens espelhadas não contam no limite de contatos nem no de mensagens. É cópia de trabalho feito em outro sistema — cobrar por ela seria cobrar duas vezes.

Como o outro sistema envia

Uma chamada por mensagem, na hora em que ela acontece: a entrada quando a pessoa escreve, a resposta assim que o bot responde. Se as duas forem enviadas juntas no fim, a conversa fica parada na tela até lá. O contrato completo está em Integrações → API pública, no recurso mirror.

curl -X POST "https://app.firezap.com.br/api/public/v1/?resource=mirror" \
  -H "Authorization: Bearer azp_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "canal_id": "ID DO CANAL ESPELHO",
    "contato_ref": "tg:8580202123",
    "contato_nome": "Carlos",
    "direcao": "entrada",
    "texto": "bom dia, o backup rodou?",
    "provider_message_id": "8580202123:4417",
    "enviada_em": "2026-09-21T13:02:11Z"
  }'
Reenviar não duplica

O provider_message_id é a chave: mandar a mesma mensagem duas vezes responde duplicada e não cria bolha repetida. Se o outro sistema cair no meio do caminho, ele pode reenviar sem medo.

Ficou alguma dúvida neste passo?
Falar com o suporte