> ## Documentation Index > Fetch the complete documentation index at: https://help.goghl.ai/llms.txt > Use this file to discover all available pages before exploring further. # Alterar Participante de Grupo do WhatsApp > A ação Alterar Participante de Grupo do WhatsApp permite adicionar ou remover um membro de um grupo do WhatsApp automaticamente a partir dos seus fluxos de trabalho do CRM, sem gerenciamento manual do grupo. > Por que isso importa: Manter os grupos do WhatsApp atualizados manualmente é lento e sujeito a erros. Com esta ação você pode adicionar automaticamente novos clientes a um grupo quando eles convertem, ou removê-los quando cancelam ou saem, tudo acionado por qualquer evento do CRM. *** ## Principais Benefícios[​](#principais-beneficios "Link direto para Principais Benefícios") **Associação Automatizada** - Adicione ou remova membros com base em eventos do CRM **Sem Gerenciamento Manual do Grupo** - Pare de adicionar e remover pessoas manualmente **Integração com Fluxos de Trabalho** - Combine com qualquer gatilho do CRM para uma automação poderosa **Participantes Dinâmicos** - Use variáveis de contato para atingir a pessoa certa sempre *** ## Quem Deve Usar[​](#quem-deve-usar "Link direto para Quem Deve Usar") **Equipes de Vendas** - Adicione novos clientes a um grupo VIP no momento em que eles convertem **Equipes de Suporte** - Remova membros de um grupo assim que o caso deles for encerrado **Agências** - Mantenha os grupos de comunidade de clientes sincronizados com seu CRM automaticamente **Criadores de Cursos** - Adicione alunos a um grupo de turma na inscrição, remova ao concluir *** ## Como Configurar[​](#como-configurar "Link direto para Como Configurar") ### Passo 1: Adicionar a Ação[​](#passo-1-adicionar-a-acao "Link direto para Passo 1: Adicionar a Ação") Vá para **Automação → Fluxos de Trabalho** Crie um novo fluxo de trabalho ou edite um existente Adicione o gatilho desejado (Formulário Enviado, Etiqueta Adicionada, Agendamento Marcado, etc.) Clique em **+** para adicionar uma nova ação e selecione **Alterar Participante de Grupo do WhatsApp** ### Passo 2: Configurar a Ação[​](#passo-2-configurar-a-acao "Link direto para Passo 2: Configurar a Ação") | Campo | Obrigatório | Descrição | | ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome da Ação** | Não | Um rótulo para esta etapa no seu fluxo de trabalho | | **Ação** | Sim | Escolha **Adicionar** ou **Remover** | | **Grupo** | Sim | Selecione um grupo do WhatsApp ou use o Seletor de Valor Personalizado. Você pode adicionar novos grupos pelo painel de configurações do WhatsApp | | **Participante** | Sim | O número de telefone do membro a adicionar ou remover | Configuração da ação Alterar Participante de Grupo do WhatsApp **O número do participante deve incluir o código do país.** Sempre insira o número de telefone no formato internacional completo com o código do país (por exemplo, `+14155552671`), ou insira o valor personalizado `{{contact.raw_phone}}` usando o ícone de etiqueta. Um número sem código de país — ou um campo formatado como `{{contact.phone}}` que possa omiti-lo — não corresponderá a um usuário do WhatsApp, e o participante não será adicionado nem removido. ### Passo 3: Salvar e Publicar[​](#passo-3-salvar-e-publicar "Link direto para Passo 3: Salvar e Publicar") Clique em **Salvar ação** Revise seu fluxo de trabalho completo Alterne de **Rascunho** para **Publicado** *** ## Campos da Ação Explicados[​](#campos-da-acao-explicados "Link direto para Campos da Ação Explicados") ### Campo Ação[​](#campo-acao "Link direto para Campo Ação") Escolha o que deve acontecer com o participante: * **Adicionar** - Adiciona o participante ao grupo selecionado * **Remover** - Remove o participante do grupo selecionado ### Campo Grupo[​](#campo-grupo "Link direto para Campo Grupo") Selecione o grupo de destino no menu suspenso ou use o Seletor de Valor Personalizado para defini-lo dinamicamente. Se o seu grupo não estiver na lista, adicione-o primeiro pelo **painel de configurações do WhatsApp**. ### Campo Participante[​](#campo-participante "Link direto para Campo Participante") Insira o número de telefone da pessoa a adicionar ou remover. Deve ser um **número do WhatsApp válido no formato internacional completo**, incluindo o código do país. **Valores recomendados:** * Um número completo com código de país, ex. `+14155552671` * O valor personalizado `{{contact.raw_phone}}` — armazena o número no formato internacional bruto, incluindo o código do país Não insira um número local sem o código do país. O WhatsApp identifica os usuários pelo número internacional completo, então a ausência do código de país significa que a ação não consegue encontrar a pessoa e não faz nada silenciosamente. *** ## Saída da Ação e Filtros[​](#saida-da-acao-e-filtros "Link direto para Saída da Ação e Filtros") Após a execução, a ação retorna os seguintes valores. Você pode referenciá-los em etapas posteriores ou ramificar com base neles usando uma etapa **Se/Senão** para criar automações confiáveis. | Filtro | Tipo | Descrição | | -------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Código de Status da Ação** | Número | O código de resultado retornado pelo WhatsApp (veja a tabela abaixo). Use-o para ramificar seu fluxo de trabalho — por exemplo, enviar um link de convite em `408` | | **Membro Adicionado?** | Booleano | `true` ou `false` — se o membro acabou adicionado ao grupo | | **Número de Telefone do Membro** | Texto | O número do participante sobre o qual a ação atuou | | **Mensagem** | Texto | Uma descrição legível do resultado | ### Códigos de Status da Ação[​](#codigos-de-status-da-acao "Link direto para Códigos de Status da Ação") Use o **Código de Status da Ação** em um filtro Se/Senão para reagir a cada resultado. | Código de Status | Significado | Mensagem (Adicionar) | Mensagem (Remover) | O que significa / o que fazer | | ---------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **200** | Sucesso | Adicionado com sucesso | Removido com sucesso | Concluído. | | **403** | Proibido | Não permitido — o usuário pode ter bloqueado esta conta ou está indisponível | Não permitido — permissões insuficientes para remover este participante | **Adicionar:** o usuário-alvo bloqueou o remetente ou tem privacidade rígida — tente um link de convite. **Remover:** normalmente significa que o alvo é administrador/criador e não pode ser removido por quem não é criador. | | **404** | Número não está no WhatsApp | O número de telefone não está no WhatsApp | O número de telefone não está no WhatsApp | Verifique o número. Esta é uma falha definitiva — nenhuma nova tentativa ajudará. | | **408** | Restrições de privacidade | Não pode ser adicionado diretamente devido às configurações de privacidade — envie um link de convite em vez disso | *(n/a — só ocorre ao adicionar)* | O contato não pode ser adicionado diretamente. Envie a ele uma **mensagem de WhatsApp com o link de convite do grupo** para que ele possa entrar por conta própria. | | **409** | Já está / não está no grupo | Já está no grupo | Não está no grupo | Sinal de idempotência — é seguro tratá-lo como sucesso na maioria dos fluxos de trabalho. | ### Lidando com adições restritas por privacidade (links de convite)[​](#lidando-com-adicoes-restritas-por-privacidade-links-de-convite "Link direto para Lidando com adições restritas por privacidade (links de convite)") Alguns contatos não podem ser adicionados diretamente a um grupo por causa das configurações de privacidade do WhatsApp. Quando isso acontece, a ação retorna **`408`** (ou **`403`** ao adicionar). Em vez de tratar isso como falha, ramifique com base no código de status e envie a eles uma mensagem de WhatsApp com o link de convite do grupo para que possam entrar por conta própria: Adicione uma etapa **Se/Senão** após esta ação e verifique se o **Código de Status da Ação** é `408` (ou `403`). Nessa ramificação, adicione uma ação **Enviar Mensagem do WhatsApp** e envie ao contato uma mensagem que inclua o **link de convite** do seu grupo, para que ele possa tocar e entrar por conta própria. Opcionalmente, marque o contato (ex. `convite-enviado`) para acompanhar depois. *** ## Limitações[​](#limitacoes "Link direto para Limitações") Tenha em mente as seguintes restrições ao usar esta ação: * **Apenas adicionar e remover.** Esta ação não pode promover nem rebaixar um participante a administrador — ela apenas adiciona e remove membros. Se você precisar de mudanças de função, [avise-nos](#suporte) para que promover/rebaixar seja adicionado. * **Contêineres de comunidade são rejeitados.** Comunidades são metacontêineres. Adicionar/remover opera sobre os subgrupos vinculados (o grupo de avisos ou de discussão), não sobre a comunidade em si. * **Grupos somente de avisos são compatíveis.** Os administradores ainda podem adicionar e remover participantes normalmente. A marcação de somente avisos restringe apenas *quem pode enviar mensagens* — não restringe o gerenciamento de associação. * **Limites de taxa.** O WhatsApp pode limitar operações repetidas de participantes no mesmo grupo. Espace as alterações em massa. *** ## Casos de Uso de Exemplo[​](#casos-de-uso-de-exemplo "Link direto para Casos de Uso de Exemplo") ### Caso de Uso 1: Adicionar Novos Clientes a um Grupo VIP[​](#caso-de-uso-1 "Link direto para Caso de Uso 1: Adicionar Novos Clientes a um Grupo VIP") **Gatilho:** Etiqueta Adicionada — `cliente` **Ação:** Alterar Participante de Grupo do WhatsApp * **Ação:** Adicionar * **Grupo:** Clientes VIP * **Participante:** `{{contact.raw_phone}}` ### Caso de Uso 2: Remover Membros Quando Cancelam[​](#caso-de-uso-2 "Link direto para Caso de Uso 2: Remover Membros Quando Cancelam") **Gatilho:** Etiqueta Adicionada — `cancelado` **Ação:** Alterar Participante de Grupo do WhatsApp * **Ação:** Remover * **Grupo:** Clientes VIP * **Participante:** `{{contact.raw_phone}}` *** ## Perguntas Frequentes[​](#perguntas-frequentes "Link direto para Perguntas Frequentes") Sempre use o formato internacional completo com o código do país — por exemplo, `+14155552671`. A opção mais fácil e confiável é inserir o valor personalizado **`{{contact.raw_phone}}`**, que já armazena o número com o código do país. Um número inserido sem código de país não corresponderá a um usuário do WhatsApp e a ação falhará. Recomendamos **`{{contact.raw_phone}}`**. Dependendo de como um contato foi criado, `{{contact.phone}}` pode estar formatado ou armazenado sem o código do país, o que faz a correspondência do participante falhar. `{{contact.raw_phone}}` mantém o número no formato internacional completo. A causa mais comum é um número de telefone sem código de país. Certifique-se de que o campo Participante use um número internacional completo (ex. `+14155552671`) ou `{{contact.raw_phone}}`. Confirme também que seu número do WhatsApp está conectado e que o grupo está disponível nas suas configurações do WhatsApp. Os grupos precisam estar adicionados e disponíveis primeiro no seu painel de configurações do WhatsApp. Adicione o grupo lá, depois volte ao fluxo de trabalho e atualize. A ação falhará ao ser executada. Recomendamos configurar o gatilho **WhatsApp Desconectado** para receber alertas quando seu número ficar offline. *** ## Suporte[​](#suporte "Link direto para Suporte") Se você precisar de ajuda com a configuração ou a integração: * Suporte por WhatsApp: [Converse no WhatsApp](https://wa.me/+12267248710?text=Ol%C3%A1%2C%20preciso%20de%20ajuda%20com%20a%20a%C3%A7%C3%A3o%20Alterar%20Participante%20de%20Grupo%20do%20WhatsApp.) * E-mail: [**support@goghl.ai**](mailto:support@goghl.ai)