> ## Documentation Index > Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Conversas e grupos do WhatsApp > Atenda quem escreve para os seus números na inbox Conversas e gerencie os grupos do WhatsApp sem sair do painel As conversas individuais do WhatsApp ficam na inbox **Conversas**, no topo do menu, junto com as de Instagram, Messenger, TikTok, Telegram e do chat do site. Números conectados pelo app WhatsApp Business (coexistência) também aparecem aqui: veja [WhatsApp](https://docs.octasend.com.br/guias/whatsapp.md). Mensagens com mais tempo que o prazo do seu plano (12 meses, por padrão) saem das conversas e dos grupos e ficam em **Conversas → Mensagens arquivadas**, para download (veja [Configurações](https://docs.octasend.com.br/plataforma/configuracoes.md#mensagens-arquivadas)). Os grupos ficam no item **WhatsApp → Grupos**. | Tela | O que você faz nela | | - | - | | **Conversas** | Lê as conversas individuais dos seus números (Evolution API e Meta Cloud API), vê o que o [chatbot](https://docs.octasend.com.br/plataforma/chatbot.md) respondeu, assume, atribui e responde. Veja [Conversas](#conversas). | | **WhatsApp → Grupos** | Acompanha e envia mensagens para os grupos de que o seu número participa, vê os participantes, salva participantes como contatos, cria grupos novos e edita os existentes. | ## Antes de começar | Requisito | Por quê | | - | - | | Número conectado em **Configurações → Canais → WhatsApp** | **Conversas** aceita números conectados pela **Evolution API** (QR code) e pela **Meta Cloud API**. **Grupos** só funciona com números conectados por QR code. Veja o guia de [WhatsApp](https://docs.octasend.com.br/guias/whatsapp.md). | > [!NOTE] > > O menu **WhatsApp** vem liberado por padrão, mas pode ser desativado para a sua conta. Se ele não aparece no seu painel, fale com a OctaSend para ativar. Com o menu desativado, abrir o endereço de uma dessas telas leva você de volta ao **Dashboard**. Todos os usuários da sua conta acessam as duas telas. Nas respostas enviadas pelo painel fica registrado quem enviou. Se a sessão do QR code cair, aparece o aviso **WhatsApp (Evolution) desconectado** no menu lateral. Clique nele para abrir a tela do canal e ler o QR code de novo. ## Conversas Abra **Conversas** no topo do menu (o endereço antigo **WhatsApp → Conversas** leva para lá). O histórico das conversas anteriores foi trazido para a inbox. Use o filtro de canal para ver só o WhatsApp. | Aba | O que mostra | | - | - | | **Minhas** | Conversas atribuídas a você. | | **Sem dono** | Conversas abertas sem atendente — é onde as mensagens novas chegam. | | **Todas** | Todas as conversas abertas. | | **Resolvidas** | Conversas encerradas. Se o cliente escrever de novo, a conversa reabre sozinha. | Dentro da conversa: * **Assumir** atribui a conversa a você, e o chatbot para de responder nela. **Atribuir a…** passa para outra pessoa da equipe. **Devolver ao bot** tira o atendente e deixa o bot responder de novo. * **Resolver** encerra a conversa; **Reabrir** volta a abri-la. * No campo de mensagem, digite **/** para usar uma resposta pronta, ou anexe um arquivo. * Vincule a conversa a um contato de [Contatos](https://docs.octasend.com.br/plataforma/contatos.md) ou crie um novo. * Cada pessoa da equipe vê as próprias mensagens não lidas, e a lista se atualiza sozinha quando chega mensagem nova. O funcionamento da inbox é o mesmo para todos os canais. Veja também [Instagram e Messenger](https://docs.octasend.com.br/guias/instagram-messenger.md). > [!TIP] > > Toda mensagem recebida numa conversa individual cria ou atualiza o contato daquele telefone em [Contatos](https://docs.octasend.com.br/plataforma/contatos.md), mesmo que a conta não tenha nenhum bot. Nas mensagens recebidas, o nome do perfil do WhatsApp só preenche contato que ainda não tem nome: o nome que você cadastrou não é trocado por elas. O mesmo vale para **Salvar todos**, nos participantes de um grupo (veja [Participantes](#participantes)). > [!NOTE] > > A conversa mostra as mensagens recebidas, as respostas do chatbot e o que a sua equipe envia pelo painel. **Não aparecem** as mensagens enviadas direto pelo aplicativo do WhatsApp no celular nem os envios de comunicações, campanhas e automações. Para esses, use os [Logs de mensagens](https://docs.octasend.com.br/plataforma/logs-de-mensagens.md). Regras do envio manual: * A resposta sai pelo **mesmo número em que a pessoa escreveu**. Se essa conexão estiver desativada, o envio é recusado até você reativá-la. * Nos números da **Meta Cloud API**, a resposta livre só é aceita até 24 horas depois da última mensagem do cliente (regra do WhatsApp). * Variáveis como `{{nome}}` **não são substituídas** nas conversas nem nos grupos: o texto sai exatamente como foi digitado. ### Transcrição de áudios Os áudios que chegam nas conversas individuais podem ser transcritos. O comportamento é definido em **Configurações → Geral**, seção **Conversas**, campo **Transcrição de áudios** (veja [Configurações](https://docs.octasend.com.br/plataforma/configuracoes.md)): | Opção | O que acontece | | - | - | | **Desligada** (padrão) | Os áudios não são transcritos e o chatbot não responde mensagens de voz. | | **Automática** | Todo áudio recebido é transcrito assim que chega. | | **Ao clicar** | Cada áudio ganha o botão **Transcrever**, e você escolhe quais transcrever. Em conversas com o bot ativo, o áudio é transcrito sempre, para o bot poder responder. | Na conversa, enquanto a transcrição roda aparece **Transcrevendo…**; quando termina, o texto aparece embaixo do áudio com o rótulo **Transcrição**. Se falhar, ou se ficar mais de 2 minutos sem resposta, aparece "Não foi possível transcrever o áudio." com o botão **Transcrever de novo**. Áudios com mais de **5 minutos** não são transcritos e mostram o aviso "Áudio longo demais para transcrever (máximo de 5 minutos)." A transcrição vale só para as conversas individuais. Áudios recebidos em grupos não são transcritos. ## Grupos Abra **WhatsApp → Grupos**. À esquerda fica a lista de grupos, em ordem alfabética, com a quantidade de participantes. Ao clicar num grupo, o painel da direita mostra as abas **Conversa** e **Participantes**, e o botão de lápis **Editar grupo**. Se a conta não tem nenhum número conectado via QR code, a tela mostra o aviso "Grupos de WhatsApp só estão disponíveis para conexões via Evolution API" e os botões de sincronizar e criar grupo não aparecem. ### Sincronizar grupos Clique em **Sincronizar grupos** para trazer todos os grupos de que o seu número participa, com nome e quantidade de participantes. Ao terminar, aparece o aviso com quantos grupos foram sincronizados. * A sincronização é **manual**. Rode de novo quando o seu número entrar em grupos novos ou quando o nome de um grupo mudar pelo celular. * Grupos de que o seu número saiu (ou que foram apagados) continuam na lista com a marcação **inativo**, e o histórico é mantido. Não é possível enviar mensagens para eles. * Se chegar mensagem de um grupo que ainda não foi sincronizado, ele aparece sozinho na lista como **Sem nome** até a próxima sincronização. * A quantidade de participantes aparece como **?** quando o WhatsApp não informou o número. > [!NOTE] > > Com mais de um número conectado via QR code, aparece um seletor de conexão ao lado dos botões. Ele define **qual número** é sincronizado e **em qual número** o grupo novo é criado. A lista mostra os grupos de todos os números. ### Conversa do grupo A aba **Conversa** mostra o histórico do grupo e se atualiza sozinha quando chega mensagem nova. * Cada mensagem recebida mostra quem enviou: o nome do contato e o telefone, se o participante já é um contato salvo, ou só o telefone. * Imagens, vídeos, áudios e documentos recebidos aparecem na própria conversa. * Mensagens enviadas pelo seu número direto do celular não aparecem no histórico, só as enviadas pelo painel. Para enviar, use o campo **Digite uma mensagem...** ou o botão **+** para o editor completo, como nas conversas individuais (veja [Tipos de mensagem](#tipos-de-mensagem)). A mensagem sai pelo número ao qual o grupo pertence. ### Participantes A aba **Participantes** consulta o WhatsApp na hora, toda vez que você a abre, então mostra quem está no grupo agora. * Cada participante aparece com foto, nome e telefone. O nome segue a mesma ordem das conversas: contato salvo, nome do perfil do WhatsApp ou telefone. * Administradores do grupo têm um ícone de escudo ao lado do nome. * Quem já é contato aparece com **· já é contato**. O mesmo celular é reconhecido com e sem o nono dígito. * Participantes que ocultam o número no WhatsApp não aparecem na lista. * Use **Buscar por nome ou telefone...** para filtrar. Ações disponíveis: | Ação | O que faz | | - | - | | **Abrir conversa** (ícone de balão) | Abre a conversa individual com o participante em **Conversas**, mesmo que ele nunca tenha escrito para você. Exige pelo menos um bot na conta; sem bot, aparece o erro "Nenhum chatbot cadastrado neste cliente — crie um bot para abrir conversas de WhatsApp." | | **Salvar como contato** (ícone de pessoa) | Salva o participante em [Contatos](https://docs.octasend.com.br/plataforma/contatos.md). Só aparece para quem ainda não é contato. | | **Salvar todos** | Salva de uma vez todos os participantes do grupo, inclusive os que a busca estiver escondendo. Ao terminar, mostra quantos contatos foram salvos e quantos já existiam. | Regras de **Salvar todos**: * O contato novo recebe o nome do perfil do WhatsApp; se o participante não tiver nome no perfil, recebe o telefone como nome. * Quem já é contato, com o mesmo telefone e sem e-mail, é contado em **já existiam**, e o nome e o telefone que você cadastrou ficam como estão. Só um contato ainda sem nome recebe o nome do perfil do WhatsApp. * O mesmo celular com e sem o nono dígito é reconhecido como o mesmo contato, sem criar duplicata. * Um contato que já tem e-mail e o mesmo telefone não é usado: um contato novo é criado para o participante e contado como salvo. * A contagem de salvos e de já existiam bate com o que foi gravado. > [!WARNING] > > Salvar participantes como contatos não significa que eles aceitaram receber as suas comunicações. Tenha o consentimento de cada pessoa antes de incluí-la em [campanhas](https://docs.octasend.com.br/plataforma/campanhas.md) ou [automações](https://docs.octasend.com.br/plataforma/automacoes.md). ### Criar grupo **1. Abra a criação** Em **Grupos**, clique em **Criar grupo**. Se tiver mais de um número conectado, escolha antes, no seletor, em qual número o grupo será criado. **2. Dê nome ao grupo** Preencha **Nome do grupo** (obrigatório) e, se quiser, **Descrição (opcional)**. **3. Escolha os participantes** Em **Buscar nos contatos**, digite um nome ou telefone e clique no contato (a busca mostra até 20 resultados, só de contatos com telefone). Ou digite o número em **Ou digite um número** e pressione **Enter** ou clique em **+**. O mesmo número digitado em formatos diferentes não entra duas vezes. **4. Crie** Clique em **Criar grupo**. O botão só fica disponível com o nome preenchido e pelo menos um participante. > [!TIP] > > Digite o número com código do país e DDD, como no exemplo do campo: `+55 11 99999-9999`. Número com menos de 10 dígitos é recusado com o aviso "Número inválido". Depois da criação, a tela **Grupo criado** mostra: * quantos participantes entraram; * quem **não entrou**. Normalmente é quem restringiu, na privacidade, quem pode colocá-lo em grupos, mas qualquer número que o WhatsApp não aceitou aparece aqui; * o **Link de convite** do grupo, com botão para copiar. O grupo novo já aparece na lista, sem precisar sincronizar. #### Convite para quem não entrou Para quem não entrou, clique em **Enviar convite por mensagem**. Cada pessoa recebe, numa conversa individual e pelo número do grupo, a mensagem: > Você foi convidado para o grupo "Nome do grupo". Entre por aqui: link-do-convite * O convite **só é enviado quando você clica**, nunca automaticamente ao criar o grupo. * O botão vale uma vez: depois do envio ele muda para **Convite enviado**. Se alguns envios falharem, o aviso mostra quantos convites foram enviados e quantos falharam. * Cada convite fica registrado em **Conversas**, com o nome de quem enviou, quando a conta tem pelo menos um bot. * O envio por mensagem existe só nesta tela, logo após criar o grupo. Depois de fechá-la, para convidar alguém, compartilhe o link do grupo pelo próprio WhatsApp. > [!WARNING] > > Se a tela mostrar um aviso dizendo que o grupo **foi criado** mas não pôde ser identificado ou não apareceu na lista, **não crie de novo**: o grupo já existe no WhatsApp. Clique em **Sincronizar grupos** para trazê-lo para a lista. ### Editar grupo Com o grupo aberto, clique no lápis **Editar grupo**. Os dados atuais são lidos do WhatsApp na hora. Só é possível editar quando o **seu número é administrador do grupo**. Se não for, a tela avisa e sugere pedir a um administrador para promover o número, ou fazer a alteração pelo celular. | Campo | Regras | | - | - | | **Nome do grupo** | Troca o nome no WhatsApp e na lista do painel. | | **Descrição** | Apagar todo o texto remove a descrição do grupo. | | **Imagem** | JPG ou PNG, até 5 MB. | | **Quem pode enviar mensagens** | **Todos os participantes** ou **Só administradores**. Ao mudar para **Só administradores**, o painel pede confirmação, porque os participantes deixam de poder enviar mensagens na hora. | | **Quem pode editar os dados do grupo** | **Todos os participantes** ou **Só administradores**. | O botão **Salvar** só fica disponível quando algo mudou, e só os campos alterados são enviados ao WhatsApp. Cada campo é aplicado separadamente: ao terminar, a tela lista o que foi **Alterado** e o que **Não foi possível alterar**. ## Tipos de mensagem O editor completo (botão **+**) é o mesmo nas conversas e nos grupos. O campo **Texto da mensagem** tem atalhos de formatação do WhatsApp: negrito, itálico, tachado, código, monoespaçado, lista com marcadores, lista numerada e citação. | Tipo | Como funciona | Limites | | - | - | - | | **Texto** | Só o texto. | — | | **Mídia (imagem/vídeo/arquivo)** | Escolha **Imagem**, **Vídeo** ou **Documento/Arquivo**, informe uma URL `https://` ou faça upload. O texto vira a legenda. | Upload de até 16 MB | | **Áudio** | URL `https://` ou upload de MP3 ou OGG. O texto, se preenchido, é enviado logo depois do áudio. | Upload de até 16 MB | | **Botões** | Botões de **Resposta**, **Link** (URL `https://`) ou **Ligar** (telefone), com título e rodapé opcionais. | Até 3 botões, com até 20 caracteres de texto cada | | **Lista de opções** | Um botão que abre uma lista com seções e itens. O texto do botão, o título de cada seção e o título de cada item são obrigatórios; a descrição do item é opcional. | Até 10 seções, com até 10 itens cada | | **Carrossel (sequência de mídias)** | Cada card tem uma imagem ou vídeo MP4, legenda e botões de link. Cada card chega como uma mensagem separada, uma logo depois da outra, e os botões de link viram links na legenda. | Até 10 cards, com até 2 botões de link cada | * O upload aceita imagens JPG, PNG, WEBP e GIF, vídeo MP4, áudio MP3 e OGG, PDF, Word (DOC, DOCX) e Excel (XLS, XLSX). * **Botões** e **Lista de opções** dependem do aparelho de quem recebe. Se o envio interativo falhar, a mensagem é reenviada automaticamente como texto com as opções numeradas. Para os detalhes de cada formato no envio pela API, veja [Enviar mensagens](https://docs.octasend.com.br/api-reference/enviar-mensagens.md). ## Limites | Item | Limite | | - | - | | Arquivo enviado por upload nos grupos | 16 MB | | Áudio para transcrição | 5 minutos | | Resultados da busca de contatos ao criar grupo | 20 | | Imagem do grupo | JPG ou PNG, até 5 MB | ## Cuidados para evitar bloqueio O método Evolution API usa um número de WhatsApp comum, por automação não oficial. Volume alto ou padrão de envio parecido com spam pode levar o WhatsApp a **suspender ou banir o número**. A plataforma não limita a quantidade de mensagens enviadas por estas telas, então o cuidado é seu. A aba **Boas Práticas**, na tela do canal WhatsApp, traz as recomendações completas. As principais: * Em números novos, comece com no máximo **100 mensagens por dia** e aumente de 10% a 20% por semana. * Aguarde pelo menos **3 segundos** entre um envio e outro. * Não mande mais de **3 mensagens seguidas** para o mesmo contato sem resposta. * Envie apenas entre **8h e 20h** no fuso de quem recebe. * Tenha o consentimento (opt-in) de quem recebe. Nunca use listas compradas. * Evite links encurtados, caixa alta em excesso e palavras como "GRÁTIS" e "URGENTE". * Mantenha uso normal no número, enviando e recebendo mensagens além dos disparos. * Se a taxa de bloqueios passar de **2%**, pause os envios. Nos grupos, em especial: adicione só quem concordou em participar. Para quem restringiu ser adicionado a grupos, use o convite, que depende de um clique seu justamente para não virar envio em massa sem intenção. ## Problemas comuns > [accordion] As mensagens recebidas não aparecem em Conversas > > Confira se o número está conectado e ativo em **Configurações → Canais → WhatsApp** e se o filtro de canal e a aba da inbox não estão escondendo a conversa (mensagens novas chegam em **Sem dono**). Mensagens que você envia direto pelo celular não aparecem. > [accordion] O chatbot não respondeu o cliente > > Se a conversa tem atendente, o bot não responde nela. Use **Devolver ao bot** para devolvê-la. Confira também se o número está marcado em **Canais atendidos** do bot e se o bot está ligado. Veja [Chatbot](https://docs.octasend.com.br/plataforma/chatbot.md). > [accordion] Nenhum chatbot cadastrado neste cliente > > Aparece ao usar **Abrir conversa** nos participantes de um grupo quando a conta não tem nenhum bot. Crie um em **Chatbot → Chatbot WhatsApp**. Ele não precisa estar ligado. > [accordion] Você não faz mais parte deste grupo > > O grupo está **inativo**: o seu número saiu dele ou o grupo foi apagado. O histórico continua disponível, mas não é possível enviar mensagens. > [accordion] Não foi possível carregar os participantes (ou o grupo) > > Os participantes e os dados para edição são consultados no WhatsApp na hora. Verifique se o número está conectado em **Configurações → Canais → WhatsApp** e tente de novo. > [accordion] Um grupo não aparece na lista > > Clique em **Sincronizar grupos**. Se você tem mais de um número conectado, escolha no seletor o número que participa do grupo antes de sincronizar. > [card] [Chatbot com IA](https://docs.octasend.com.br/plataforma/chatbot.md) > > Responda automaticamente as conversas do WhatsApp. > [card] [Guia de WhatsApp](https://docs.octasend.com.br/guias/whatsapp.md) > > Conecte o seu número por QR code. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.