Cosmobots

Português

English

Português

English

Appearance

Inboxes ​

Uma inbox é um canal por onde mensagens chegam: um número WhatsApp, um widget Web Chat, uma conta de e-mail, um bot Telegram. Cada canal vira uma inbox separada — você pode ter quantas quiser, mesmo do mesmo tipo (vários números WhatsApp, por exemplo).

Onde fica ​

Configurações → Inboxes.

A lista mostra todas as inboxes da conta com canal, status, atendentes e bot conectado. Clique em qualquer uma para entrar nas configurações dela.

Criar uma inbox ​

Configurações → Inboxes → Adicionar inbox → escolha o canal:

Web Chat ​

O canal mais simples — pronto em 2 minutos.

Setup ​

  1. Adicionar inbox → Web Chat.
  2. Nome do site (interno, para você reconhecer).
  3. URL do site (para pré-validação CORS).
  4. Cor primária (hex) — define botão e cabeçalho do widget.
  5. Mensagem de boas-vindas — primeira frase que aparece no widget aberto.
  6. Resposta automática (opcional) — bot manda em 5s se ninguém respondeu ainda.

Salve e na próxima tela aparece o snippet de embed — JavaScript de ~10 linhas. Cole no <head> do seu site (todas as páginas onde quer o widget).

Customização avançada ​

Após criada, em Inbox → Configurações:

  • Pre-chat form — pergunte nome/e-mail antes de iniciar conversa.
  • Business hours — fora do horário, mostra mensagem fixa em vez do widget de chat.
  • Heads up — banner no topo do widget com mensagem fixa (ex.: "Tempo médio de resposta: 5 min").
  • Branding — logo, cor secundária, posição (canto direito vs esquerdo).
  • Domínios permitidos — restringe onde o widget pode rodar (whitelist CORS).

Bot pre-conversa ​

Conecte um bot Cosmoflow para qualificar lead antes de envolver atendente. Ver Bots → Conectar a inboxes.

WhatsApp Business API ​

Canal mais poderoso, mas com setup específico.

Pré-requisitos ​

  • Conta Meta Business verificada (selo azul ou amarelo).
  • Número de telefone dedicado (não pode estar em uso no app WhatsApp pessoal/business comum).
  • Cartão de crédito vinculado à Meta Business (para conversation fees da Meta).

Setup (assistido) ​

A configuração inicial é assistida pela equipe Cosmobots — abra um chamado em desk.cosmobots.io com:

  • Nome da empresa (como vai aparecer no perfil)
  • Número desejado
  • Categoria do negócio
  • Logo + descrição curta

Em até 2 dias úteis o número está aprovado e ativo. A partir daí, mensagens caem automaticamente na inbox criada.

Templates ​

WhatsApp exige templates aprovados para qualquer mensagem fora da janela de 24h após a última mensagem do cliente.

Em Configurações → WhatsApp templates:

  • Criar template — nome, idioma, categoria (Marketing/Utility/Authentication), corpo com variáveis 1, 2 etc.
  • Submeter para aprovação — Meta responde em horas a dias.
  • Status — Approved / Pending / Rejected.

Cada categoria tem custo diferente (ver Faturamento).

Janela de 24h ​

Cliente mandou mensagem → 24h livres para você responder qualquer coisa. Passou de 24h sem resposta dele → você só pode mandar templates aprovados (Marketing/Utility/Authentication, depende do caso).

A plataforma rastreia automaticamente; o editor de mensagem avisa quando você está fora da janela.

Custos da Meta vs custos Cosmobots ​

São cobranças separadas:

  • Meta — cobra por categoria de conversa iniciada (Marketing tem maior custo, Service costuma ser gratuito até X/mês).
  • Cosmobots — cobra por novas conversas no plano + pacote de broadcasts (ver Faturamento).

A fatura WhatsApp da Meta vem direto pra você no cartão deles. A Cosmobots não tem visibilidade nem cobrança disso.

E-mail ​

Modos ​

Encaminhamento (recomendado) — você cria uma regra de forward em suporte@suaempresa.com para o endereço único gerado pela Cosmobots (algo como acct123-inbox45@in.cosmobots.io). Mensagens chegam, atendente responde, resposta sai com From: suporte@suaempresa.com (a gente faz spoof legítimo via DKIM/SPF do nosso domínio + alias).

IMAP — mais antigo, conectamos direto à sua caixa via IMAP. Use só se forwarding não for opção.

SPF/DKIM ​

Para que respostas saiam com From: suporte@suaempresa.com sem cair em spam, configure:

  • SPF — adicione include:cosmobots.io no TXT do seu domínio.
  • DKIM — adicione o registro CNAME que aparece em Inbox → Configurações → Email Setup → DKIM.

Sem isso, respostas saem com aviso "via cosmobots.io" no Gmail.

Assinatura ​

Cada inbox e-mail tem assinatura padrão (em Inbox → Configurações → Assinatura). Atendentes podem sobrescrever individualmente em Perfil → Assinatura por inbox.

Telegram ​

Setup ​

  1. No Telegram, fale com @BotFather → /newbot → escolha nome e username (precisa terminar em bot, ex.: suporteSuaEmpresaBot).
  2. BotFather te dá um token — copie.
  3. Cosmobots → Adicionar inbox → Telegram → cole o token + nome interno → salve.

Pronto. O bot Telegram está vivo e mensagens caem na inbox.

Limitações ​

  • Telegram exige usuários conhecerem o bot e darem /start antes de você mandar primeira mensagem (sem broadcasts a frio).
  • Sem botões inline complexos no fluxo (apenas teclados básicos).
  • Sem anexos pesados (>50 MB).

API ​

Canal genérico — você implementa a comunicação. Útil para:

  • Apps mobile próprios (Cosmobots vira backend de mensageria).
  • IVR de voz (URA) que escreve transcrição na conversa.
  • Sistemas internos legados (intranet com chat embutido).

Setup em Adicionar inbox → API:

  • Você recebe um inbox_identifier e endpoints para criar contato, criar conversa e mandar mensagem.
  • Webhook de saída — você fornece URL onde a Cosmobots vai bater quando atendente responder.

Documentação técnica completa em api.cosmobots.io/docs (em construção).

Configurações comuns por inbox ​

Independente do canal, toda inbox tem:

Atendentes ​

Inbox → Configurações → Collaborators — quem tem acesso. Pode ser uma lista de pessoas, times, ou ambos.

Auto Assignment ​

Inbox → Configurações → Configuration → Auto Assignment — distribui automaticamente entre os Collaborators. Modos:

  • Round Robin — rodízio simples por contagem.
  • Balanced — leva em conta a carga ativa de cada um.

Auto-close ​

Inbox → Configurações → Configuration → Auto-close conversations — após N tempo sem mensagem nova, a conversa vira Closed (irreversível).

Faixa: 1 hora a 7 dias. Padrão: 7 dias.

Closed é definitivo

Conversas Closed não podem ser reabertas — só Resolved podem. Se a inbox tem auto-close de 1 dia, depois desse prazo o cliente precisa abrir conversa nova.

Bot ​

Inbox → Configurações → Configuration → Bot — qual bot responde mensagens dessa inbox. Ver Bots → Conectar a inboxes.

Business hours ​

Inbox → Configurações → Business Hours — define horário de atendimento por dia da semana. Fora do horário:

  • Web Chat — mostra mensagem fixa configurada.
  • WhatsApp/Email/Telegram — bot pode responder com mensagem fora-do-ar (use bloco "Condição" com variável &#123;&#123;now&#125;&#125; no fluxo).

Limites ​

Sem limite de inboxes por conta. O custo é nas conversas que cada inbox gera. Plano Rocket suporta tipicamente 1-3 inboxes ativas; Spaceship em diante, dezenas sem problema.

Cosmobots — plataforma de atendimento conversacional

© 2026 Cosmobots