Filtros de Tags nas Extrações do ActiveCampaign

A API do ActiveCampaign permite o uso de tags como filtros para segmentar contatos em suas queries e extrações. Essa funcionalidade é essencial para identificar grupos específicos de contatos com base em classificações ou ações previamente atribuídas.

Como usar filtros de tags

Campo Tag Name

1. Na query, você pode utilizar o campo Tag Name para especificar uma ou mais tags como filtro.
2. Caso queira filtrar por múltiplas tags, basta separá-las por ponto e vírgula (tag1; tag2; tag3).
3. A condição do filtro é OU, isso significa que pode conter uma tag ou a outra.

Uso na Sidebar

4. As tags devem ser configuradas exclusivamente no campo específico da sidebar, chamado Tag Name (opcional).
5. Esse campo serve apenas como filtro e não pode ser usado em conjunto com outros campos de contato, como Contact Name ou Contact Email, na mesma extração.

Limitação importante

A API não permite combinar campos de tags com campos de contato na mesma query. Por exemplo, ao tentar usar Contact Name e Tag Name simultaneamente, a query resultará em erro. Portanto, é necessário configurar os filtros de tags separadamente.

Exemplo de uso correto

Para filtrar contatos que possuem as tags “cliente” ou “newsletter”, insira no campo Tag Name da sidebar separados por ponto e vírgula:1

Essa configuração retornará apenas os contatos filtrados associados a essas tags.

Considerações sobre contatos com múltiplas tags

Muitos contatos possuem várias tags associadas. Por isso, é recomendável organizar suas queries para garantir que as informações sejam extraídas corretamente, sempre respeitando a separação entre os campos de contato e os filtros de tags.

Se precisar de suporte adicional para configurar suas queries no ActiveCampaign, entre em contato com a equipe da Stract.