---
title: "Dividir cadeia de caracteres em elementos de um array"
description: "Transforma um texto com vírgulas numa lista de verdade."
url: https://ajuda.customerx.com.br/pt-br/articles/204-dividir-cadeia-de-caracteres-em-elementos-de-um-array
collection: "Ferramentas"
updated: 2026-06-08
language: pt-br
---

# Dividir cadeia de caracteres em elementos de um array

Transforma um texto com vírgulas numa lista de verdade.

Transforma um texto com vírgulas numa lista de verdade.

> **Info:** O CX Connect fica em cliente.customerx.com.br/connect, na aba Automações. Você pode ver as ações de cada app antes de conectar qualquer conta, e cada dado gravado consome uma transação do plano.

## O que ela faz, em bom português

Traduzindo o nome técnico: "cadeia de caracteres" é texto; "array" é lista. Ou seja: transforma um texto separado por algum caractere ("Pro;Onboarding;Treinamento") numa lista com três itens de verdade, que as outras ferramentas de lista conseguem usar (Iterador, Filter row elements, Agregador).

## Quando usar no dia a dia de CS

-   Um campo veio com vários valores grudados num texto só e você precisa tratá-los como itens separados.
    
-   Preparar dados colados de uma planilha ou de um campo de formulário com múltiplos valores.
    

## Como configurar, passo a passo

1.  Clique no sinal de mais entre as etapas e escolha **Ferramenta**, depois **Dividir cadeia de caracteres em elementos de uma seção de linha (array)** e **Selecionar**.
    
2.  Indique o campo de texto e o separador (vírgula, ponto e vírgula...).
    
3.  A lista resultante fica disponível para as próximas etapas.
    

## Exemplo do mundo real

O campo "produtos contratados" chega como "Pro;Onboarding;Treinamento". A ferramenta divide em três itens, e o Iterador cria cada produto separadamente no registro do cliente.

## Fica a dica

Parecida com o Iterator by string, mas com uma diferença: aqui você obtém a lista para usar como quiser nas próximas etapas; lá, o fluxo já sai repetindo para cada pedaço imediatamente.

## Artigos relacionados

[

Mapeamento de campos

Como ligar os campos da ferramenta de origem aos campos do CustomerX para que os dados entrem no lugar certo.

](https://ajuda.customerx.com.br/pt-br/articles/177-mapeamento-de-campos.md)[

Testar, ativar e acompanhar

Como testar uma automação antes de ativar e onde acompanhar as execuções pelo Histórico.

](https://ajuda.customerx.com.br/pt-br/articles/178-testar-ativar-e-acompanhar.md)
