---
title: Grupos de disparo
slug: helper/grupos-de-disparo
createdAt: 2026-11-19T14:26:40.695Z
---

Um **grupo** é a lista de quem vai receber a campanha. Fica em **Contatos › Grupos de disparo**. Criar um grupo tem três etapas.

## Etapa 1 — Como importar

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/4YbZD1Ds5IMQp-bne0_CU_d3a677a836ffbf5360364acf1fd8737b.jpg" alt="Escolha se o grupo carrega as variáveis de um template" caption size="160" width="1600" height="1000"} *Escolha se o grupo carrega as variáveis de um template*

- **Apenas importar contatos** — só telefone e nome. Serve para templates sem variáveis.
- **Importar com modelo** — escolha o **fornecedor** (o número) e o **template**; a prévia mostra o texto e os botões. A planilha precisa de **uma coluna por variável**.

## Etapa 2 — O arquivo (ou contato à mão)

Arraste a planilha (`.csv`, `.tsv`, `.xlsx`, `.xls` — até 200 MB) ou clique para escolher. A tela mostra uma **prévia** das primeiras linhas e mapeia sozinha as colunas de **WhatsApp** e **Nome**. Também dá para adicionar um contato **à mão** em *Novo contato manual*, sem reenviar o arquivo.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/KEjAYXktGXxFkh7Cfn6-c_7f891b736f7135da9354bbed50d66651.jpg" alt="Prévia rápida e mapeamento das colunas" caption size="160" width="1600" height="1000"} *Prévia rápida e mapeamento das colunas*

Com modelo, aparece o **Mapeamento de colunas** das variáveis. Colunas chamadas `var1`, `var_1`, `variavel1`, `v1`, `{{1}}` ou só `1` casam sozinhas com `{{1}}` — a tela conta *Mapeadas: 5/5*. Se a planilha usar outros nomes, ligue cada variável à coluna certa.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ivZS3LtPdKFLs_JxR_UMx_a3d6d94c47f4c23d6eab1344486f7623.jpg" alt="O template decide quantas variáveis a planilha precisa ter" caption size="160" width="1600" height="1000"} *O template decide quantas variáveis a planilha precisa ter*

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/XuK3ttGjBh0Oja9iLkHSl_7bad933bed99ed111fdb4791bc736f74.jpg" alt="var1…var5 casam sozinhas com {{1}}…{{5}}" caption size="160" width="1600" height="788"} *var1…var5 casam sozinhas com …*

**Validar contatos** confere telefone por telefone (formato brasileiro; o nono dígito entra sozinho quando falta) e abre a etapa 3.

## Etapa 3 — Conferir e salvar

Resumo (total, válidos, inválidos, com aviso), a tabela com a situação de cada linha (filtre por situação ou canal) e o **nome** e a **etiqueta** do grupo. Inválidos podem ser baixados para correção. **Salvar grupo** cria a lista.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/QFa5vB6nr7-owI6XJIDHz_7de65224ad3d744bc3808e58ffc4daf8.jpg" alt="Só quem passou na validação entra" caption size="160" width="1600" height="1000"} *Só quem passou na validação entra*

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/YUlyUaq0DTI6P688JT2kW_5e5afab3a4e19238fcf8395c5a5f39c7.jpg" alt="A prévia usa os valores da primeira linha" caption size="160" width="1600" height="1000"} *A prévia usa os valores da primeira linha*

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Hwfz0pFWsMwpEgueeZJN6_250426dd62ebaaab75b846a9350a86c0.jpg" alt="Total, válidos e inválidos no cartão" caption size="160" width="1600" height="1000"} *Total, válidos e inválidos no cartão*

## O que dá para fazer com um grupo

- **Contatos** — quem está na lista, com busca e **Exportar** (CSV, Excel, HTML ou PDF). Em grupo com modelo, as variáveis aparecem como colunas `{{1}}`, `{{2}}`… O filtro **Todos / Válidos / Inválidos** mostra as linhas que a validação recusou, com o motivo; inválido nunca recebe disparo. Com um filtro ligado, **Exportar só os válidos** (ou **só os inválidos**) escolhe entre o filtro e o grupo inteiro — o arquivo de inválidos traz a coluna **Motivo**, para corrigir e importar de novo. Grupo criado antes desta versão tem só a contagem de inválidos, sem a lista.
- **Histórico** — as campanhas que já usaram o grupo.
- **Editar** — nome e etiqueta.
- **Excluir** — pede o nome do grupo para confirmar. As campanhas que já usaram o grupo mantêm o histórico delas.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/HeB9hGlUUaZwePdB9OhcL_47a4752d569c5910f04607d6c56fd83f.jpg" alt="É aqui que se confere se o template vai ser preenchido certo" caption size="160" width="1600" height="788"} *É aqui que se confere se o template vai ser preenchido certo*

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/xVlPM-CHFqQP2JNsOeS87_b6fc210fda141b51fa01045b818e868c.jpg" alt="Quais campanhas já saíram para esta lista" caption size="160" width="1600" height="1000"} *Quais campanhas já saíram para esta lista*

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/jJSa1kOlGOLk0iHOTeckD_e21bc72577738afe36ecfb0dcb8f25ec.jpg" size="160" alt="Janela Editar grupo de contatos, com nome e etiqueta" isUploading="false" initialPath="../images/e21bc72577738afe36ecfb0dcb8f25ec.jpg" githubPath="images/e21bc72577738afe36ecfb0dcb8f25ec.jpg" width="1600" height="1000" showCaption="false"}

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/PSHsjD1gF0G4YiZqJMka7_23a10e8ccae3bce7c8c1ff3feec8ec97.jpg" alt="Não dá para desfazer; o histórico das campanhas fica" caption size="160" width="1600" height="1000"} *Não dá para desfazer; o histórico das campanhas fica*

## Grupo do Teams

Para disparar por Microsoft Teams, o destinatário é uma **pessoa da organização** — e só quem já falou com o bot pode receber. **Grupo do Teams** monta essa lista (quem já falou, ou uma planilha de e-mails validada). Exige um fornecedor Teams cadastrado no tenant.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/mgW3lNqEdsHBvc__dujOL_b6c832655479739c1122b953edd49e0d.jpg" alt="Sem fornecedor Teams, a tela avisa e não deixa criar" caption size="160" width="1600" height="1000"} *Sem fornecedor Teams, a tela avisa e não deixa criar*
