# API não Oficial

{% hint style="success" %}
**Pré-requisitos:**

* Ter acesso a plataforma com perfil de administrador.
* Habilitar a funcionalidade na plataforma
  {% endhint %}

**Como Criar um Novo Grupo**

**Passo 1: Inicie a Criação**

* Na tela de Atendimentos, clique no ícone de `+` no topo da lista de conversas e selecione a nova opção "Novo grupo".

<figure><img src="/files/EJarEIMtIrYYILxeb5R2" alt=""><figcaption></figcaption></figure>

**Passo 2: Configure o Controle de Acesso**

* Nesta etapa, você define quem poderá visualizar e interagir com o grupo na plataforma.
  * **Selecionar canal de atendimento:** Escolha o canal da API Oficial que será o "dono" do grupo.
  * **Acesso ao grupo:** Decida quem terá acesso: todas as equipes, equipes específicas ou usuários selecionados individualmente.
  * **Moderadores do grupo:** Defina quem terá permissão para administrar o grupo (editar, excluir, etc.). A lista de usuários disponíveis aqui será filtrada com base em quem você deu acesso na etapa anterior.

<figure><img src="/files/x4cq4RUHmWQCTqvz5Lpn" alt=""><figcaption></figcaption></figure>

**Passo 3: Defina as Informações do Grupo**

* Nessa tela, preencha os dados de identificação do seu grupo:
  * Nome do grupo: (Obrigatório)
  * Descrição do grupo: (Opcional)
  * Etiquetas: (Opcional)

Após clicar em "Criar grupo", ele aparecerá na sua lista de atendimentos.

<figure><img src="/files/SYAqIbMvai8Ws01c4Epj" alt=""><figcaption></figcaption></figure>

#### Passo 4: Definir as Configurações do Grupo

Na última etapa, antes de finalizar a criação, o sistema exibirá o modal **"Configurações do Grupo"**. Esta tela é crucial para definir as permissões e o funcionamento do seu novo grupo.

Neste modal, você deverá configurar as seguintes opções:

* **Permissão para envio de mensagens:** Determine se `Todos os membros` ou `Apenas administradores` poderão enviar mensagens no grupo.
* **Permissão para adicionar membros:** Escolha quem terá o poder de adicionar novos participantes ao grupo.
* **Permissão para editar o grupo:** Defina se qualquer membro poderá editar as informações do grupo (nome, imagem, descrição) ou se essa permissão será restrita aos administradores.
* **Autorizar novos membros:** Ative esta opção para que a entrada de novos membros precise ser aprovada por um administrador, garantindo maior controle sobre quem participa do grupo.

Após ajustar as permissões conforme sua necessidade, clique no botão "Criar grupo" para concluir o processo.

<figure><img src="/files/myJoWz0E6bOhG197sx0Z" alt=""><figcaption></figcaption></figure>

#### Como Gerenciar um Grupo Existente

Após a criação, você pode gerenciar todas as configurações do grupo.

**Passo 1: Acesse os Detalhes do Grupo**

* Com a conversa do grupo aberta, clique no ícone de "Detalhes" (👁️) no cabeçalho para abrir o painel lateral "Dados do grupo".

**Passo 2: Explore as Opções de Gerenciamento**

* No painel "Dados do grupo", você pode:
  * **Editar** o nome, a descrição e as etiquetas.
  * **Copiar** o Link de Convite para adicionar novos membros.
  * **Redefinir** Link: Invalidar o link de convite atual e gerar um novo, para maior segurança.
  * **Alterar Acessos e Configurações:** Use o ícone no topo do painel para reabrir o modal de **"Configurações do Grupo"** e o ícone "Alterar Permissões" para reabrir o modal de **"Controle de Acesso"**.
  * **Excluir Grupo:** Não é possível excluir grupos neste tipo de canal. Você ainda pode excluir no aplicativo do WhatsApp.
  * **Gerenciando os Membros do Grupo:** Para gerenciar os participantes, acesse a lista de membros e clique no menu de três pontos (`...`) ao lado do nome do contato. As opções disponíveis variam de acordo com o status do membro:
  * **Para membros com entrada** `Pendente`:
    * **Visualizar contato:** Abre os detalhes do contato.
    * **Autorizar entrada:** Aprova a solicitação e adiciona o membro ao grupo.
    * **Remover:** Recusa a solicitação de entrada.
  * **Para membros que já participam do grupo:**
    * **Visualizar contato:** Abre os detalhes do contato.
    * **Promover a Admin de grupo:** Concede privilégios de administrador ao membro.
    * **Remover:** Expulsa o membro do grupo.
  * **Para membros que já são administradores:**
    * **Remover Acesso de Admin**: Remove os privilégios de administrador, tornando-o um membro comum.

<figure><img src="/files/Dhb0v6oaD8kmXUBlTCab" alt=""><figcaption></figcaption></figure>

#### Como Visualizar a Entrega e a Leitura de Mensagens

Para verificar quem visualizou uma mensagem específica, tanto no WhatsApp quanto na plataforma, siga os passos abaixo.

**Passo 1: Acesse os Detalhes da Mensagem**

* Na tela de atendimento, passe o mouse sobre a mensagem desejada e clique no menu de opções (`...`).
* Nos detalhes que aparecerão, clique na opção **"Visualizar".**

**Passo 2: Consulte os Status de Entrega e Leitura**

* Uma nova janela de "Visualização" será aberta, dividida em duas abas:
  * **Aba "Membros":** Mostra o status da mensagem para os contatos finais, no WhatsApp. Aqui você pode ver quem já recebeu ("Entregue para") e quem já leu ("Lida por") a mensagem.
  * **Aba "Usuários":** Mostra o status da mensagem para os usuários da sua equipe, dentro da plataforma Helena. Aqui você pode ver quais atendentes já visualizaram a mensagem.

<figure><img src="/files/lInmnpMTJ5PQaH9MiM2n" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Notificações de Alteração de Membros**

Para garantir a transparência e manter todos os participantes informados, o sistema registrará automaticamente no histórico da conversa sempre que houver uma mudança na composição do grupo.

Uma mensagem de sistema será enviada indicando quando um participante entrou ou saiu do grupo, como no exemplo abaixo.
{% endhint %}

<figure><img src="/files/F6mbsgWBg81ojKZFqg1X" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

#### Regras de Funcionamento para Grupos (API não Oficial)

Ao utilizar a funcionalidade de Grupos com um canal da API não Oficial do WhatsApp, é importante conhecer as seguintes regras e limitações:

* **Limite de Participantes:** Um grupo pode ter no máximo 1024 números participantes no total: 1023 membros (seus contatos) + 1 número da sua empresa (o canal).
* **Método de Entrada:** A única forma de um novo membro entrar no grupo é através do link de convite. Não é possível adicionar um contato diretamente.
* **Restrição Após Remoção:** Se um membro for removido do grupo por um moderador, ele não poderá entrar novamente no mesmo grupo, mesmo que utilize o link de convite.
* **Sincronização Automática:** Ao conectar um novo canal do WhatsApp à plataforma, os grupos dos quais este número já faz parte são sincronizados gradativamente em segundo plano e serão apresentados na aba "Novos" até que um administrador configure as permissões desse grupo.
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helena.app/configurando-sua-plataforma/atendimento/grupos-do-whatsapp/api-nao-oficial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.