> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Passo Recolher dados do chamador

> Como funciona o passo Recolher dados do chamador e como o pode utilizar como passo de ação nos fluxos de chamadas

<Note>
  Este artigo descreve os parâmetros e a configuração do passo **Recolher dados do chamador** no nosso Call Flow Designer.
</Note>

**Nível de utilizador:** Admin

***

**Recolher dados do chamador** é um passo disponível no [Call Flow Designer](/pt/articles/3669429-call-flow-designer-guide) da CloudTalk. Utilize-o quando os chamadores precisarem de introduzir dados no teclado do telefone que serão utilizados num passo seguinte, como um Pedido HTTP ou um encaminhamento dinâmico num passo Ligar para.

<h3 id="h_e0635eed26">
  Adicionar Recolher dados do chamador ao seu fluxo de chamadas
</h3>

1. No **Dashboard**, clique em **Números**.

2. No separador **Os meus números**, localize o número que pretende configurar.

3. Clique em **+ Configurar** (ou no nome do fluxo, se já existir) na coluna **Fluxo de chamadas**.

4. Na tela, clique no botão **+** no local onde pretende inserir o passo.

5. Na biblioteca de passos, em **Automatização**, selecione **Recolher dados do chamador**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5878950/23bb0304f000-screenshot-2026-08-17-at-15-44-53.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=1f580474c3472d6f579dc765466f529a" alt="" width="2657" height="1374" data-path="images/help-center/articles/5878950/23bb0304f000-screenshot-2026-08-17-at-15-44-53.png" />
</Frame>

<h4 id="h_f3d698295c">
  Tipos de valores (do chamador)
</h4>

| **Entrada aceite** | **Entrada esperada** |
| - | - |
| Cadeias de caracteres \[A-aZ-z0-9] | Cadeias numéricas \[0-9] ou expressões de padrão |

Embora as cadeias de caracteres sejam aceites, poderão existir soluções da CloudTalk mais adequadas para empresas que precisam de respostas longas ou de cadeias de texto dos clientes.

<Warning>
  **Importante:** NÃO peça aos chamadores que incluam o símbolo cardinal (`#`). Premir `#` termina o passo imediatamente.
</Warning>

***

<h3 id="h_3ab24e0bee">
  Configuração
</h3>

O painel de configuração do passo Recolher dados do chamador tem duas secções: um **seletor de som** na parte superior e **Recolher informações das configurações do chamador** por baixo.

<h4 id="h_f26f61a00a">
  Som
</h4>

O seletor de som funciona da mesma forma que nos passos Saudação, Menu IVR e Marcar por extensão. Pode criar um novo som, carregar um ficheiro, utilizar texto para voz ou pesquisar na sua biblioteca existente. Utilize-o para reproduzir uma mensagem que indica aos chamadores o que devem introduzir (por exemplo, «Introduza o número da sua encomenda»).

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5878950/270247c58481-screenshot-2026-08-17-at-15-50-32.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=083558c449318466e6059b7b54398d5c" alt="" width="350" data-path="images/help-center/articles/5878950/270247c58481-screenshot-2026-08-17-at-15-50-32.png" />
</Frame>

<h4 id="h_e80e8855bd">
  Recolher informações das configurações do chamador
</h4>

<Warning>
  **Nota:** Os dados introduzidos pelo chamador podem ser concluídos premindo **`#`**.
</Warning>

**Segundos a aguardar neste passo**

O tempo limite é o método predefinido para terminar o passo. O número de segundos que indicar aqui determina quanto tempo o passo aguarda antes de avançar. Certifique-se de que o tempo limite é superior à saudação que definiu, para que os chamadores tenham tempo de ouvir e responder.

**Padrão**

O campo **Padrão** espera uma [expressão regular (regex)](https://www.rexegg.com/regex-quickstart.html). Se a regex estiver formatada incorretamente, devolve null ou gera um erro durante a execução. O caráter # não é reconhecido num padrão; termina automaticamente o passo de recolha de dados.

**Repetir em caso de inválido**

Selecione esta caixa para dar ao chamador a oportunidade de repetir a introdução, caso esta não corresponda ao padrão esperado ou o tempo limite seja atingido. O número máximo de repetições é 10. No início de cada repetição, a saudação (se estiver definida) é reproduzida novamente.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5878950/a7c067de0381-screenshot-2026-08-17-at-15-52-26.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=718927ce5aa206de73b9afe418abf0fb" alt="" width="350" data-path="images/help-center/articles/5878950/a7c067de0381-screenshot-2026-08-17-at-15-52-26.png" />
</Frame>

***

<h2 id="h_8f7d51c1c3">
  Utilizar os dados recolhidos noutros passos
</h2>

<h3 id="h_650df29a5c">
  Com o Pedido HTTP
</h3>

Pode criar um fluxo em que os chamadores introduzem informações (como o número da encomenda) que são depois enviadas através de um Pedido HTTP para outro sistema, como um CRM.

1. Adicione um passo **Recolher dados do chamador** seguido de um passo **Pedido HTTP** no seu fluxo.

2. No **Corpo do pedido** do Pedido HTTP, adicione um par chave-valor. No valor, referencie os dados do chamador com: `#{{input[123].value}}`, em que o número entre parêntesis retos é o *input\_id* do passo Recolher dados do chamador.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5878950/e464770ab4eb-screenshot-2026-08-17-at-17-12-09.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=b30fa0a188e007eaa9941896afcc595a" alt="" width="1828" height="1350" data-path="images/help-center/articles/5878950/e464770ab4eb-screenshot-2026-08-17-at-17-12-09.png" />
</Frame>

Se criar ambos os passos na mesma sessão, pode introduzir um ID temporário entre parêntesis retos. O ID real substitui-o depois de clicar em **Guardar**.

Defina a **Chave** correspondente com o valor de texto esperado pelo endpoint recetor.

Selecione a caixa **Analisar resposta** se for necessária uma resposta HTTP para continuar o fluxo. Se não estiver selecionada, o fluxo continua depois de o pedido ser enviado, independentemente de ter sido recebida uma resposta.

<h3 id="h_2bfdeaa414">
  Com Ligar para (encaminhamento dinâmico)
</h3>

Utilize os dados recolhidos para encaminhar dinamicamente a chamada para um agente, um grupo ou o correio de voz com base no que o chamador introduziu.

1. Adicione um passo **Recolher dados do chamador** seguido de um passo **Ligar para**.

2. No painel de configuração de Ligar para, clique em **Encaminhar dinamicamente através de variável**.

3. No campo **Encaminhar para (variável)**, introduza: `#{{input.step_id}}`, em que *step\_id* é o ID do passo Recolher dados do chamador (por exemplo, `#{{input.389008}}`). Para encontrar o ID do passo, clique no menu de três pontos (⋮) no cartão Recolher dados do chamador.

<Tip>
  **Dica:** Guarde primeiro o seu fluxo antes de referenciar o ID do passo. Antes de guardar, os passos têm IDs negativos temporários que não funcionam no campo da variável. Depois de guardar, o ID do passo passa a ser um número positivo permanente.
</Tip>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5878950/0e6fd10eb018-screenshot-2026-08-17-at-17-09-08.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=2509c092a44398ca7526ee220e6e2fc2" alt="" width="1723" height="1172" data-path="images/help-center/articles/5878950/0e6fd10eb018-screenshot-2026-08-17-at-17-09-08.png" />
</Frame>

<Info>
  **Importante:** Certifique-se sempre de que os dados do chamador referenciados provêm do fluxo do mesmo número. Não tente utilizar dados recolhidos noutras ramificações da chamada. A referência cruzada entre ramificações não é suportada.
</Info>

***

*Precisa de ajuda ou tem alguma questão?* Contacte-nos através do nosso [Portal de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para si.


## Related topics

- [Inquérito pós-chamada](/pt/articles/8200861-post-call-survey.md)
- [Passo Pedido HTTP](/pt/articles/6883940-http-request-step.md)
- [Guia de encaminhamento e Call Flow Design](/pt/articles/10559796-routing-call-flow-design-guide.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.