# Atlaz - Abertura de Chamado (Super Zapp)

Neste tutorial você vai configurar a integração **Atlaz – Abertura de Chamado** no **Super Zapp**, criando a integração, a fila e o encaminhamento pelo bot para coletar **CPF/CNPJ** e abrir o chamado automaticamente.

### O que você vai precisar

* Acesso ao **painel da Atlaz** (para copiar o **Token da API**).
* Acesso ao sistema **Super Zapp** com permissão para **criar integrações**.

***

### 1) Acessar o painel da Atlaz e copiar o Token da API

No painel da Atlaz, siga o caminho:

**Painel → Configurações → Recursos**

Tela Atlaz mostrando Configurações > Recursos e o Token<br>

<figure><img src="/files/ulf9BFEGMVOfTTEZ6iNI" alt=""><figcaption></figcaption></figure>

#### Copiar o Token

* Localize o **Token da API**
* Copie e guarde — você vai usar na configuração no **Super Zapp**

***

### 2) Criar a integração no Super Zapp

Acesse o menu:

**Cadastro → Filas / Integrações → Integrações**

Clique em **Adicionar** e selecione:

**Criar chamado Atlaz**

***

### 3) Preencher os dados da integração

Preencha os campos abaixo com atenção:

#### Nome da integração

Use um nome fácil de identificar (ex.: **Chamado Atlaz**).

#### URL da integração

Informe a **URL base** do seu painel Atlaz (exemplo de demo: `https://demo.atlaz.com.br`).\
⚠️ Importante:

* **Não** coloque “/” no final
* **Não** adicione caminhos extras

#### Fila de transferência (em caso de erro)

Selecione uma fila para cair no atendimento humano se ocorrer falha.\
❌ **Não use a mesma fila da integração**.

#### API Key

Cole o **Token da API** copiado do painel Atlaz.

Tela com Nome / URL / Fila erro / API Key<br>

***

### ⏱️ Configurações de tempo (importante para evitar spam e duplicidade)

Essas opções controlam como e quando o cliente pode abrir chamados:

* **Intervalo de horas para novo chamado**: define quantas horas o cliente deve aguardar para abrir outro chamado.
* **Tempo permitido entre registros de chamados**: evita abertura excessiva em curto período.
* **Intervalo (ms) entre mensagens**: tempo entre o envio de mensagens automáticas.
* **Tempo de espera para unir mensagens do cliente**: junta mensagens “picotadas” em um único chamado.

✅ Recomendação documentada: **15000 ms (15 segundos)** como mínimo indicado.

***

### 4) Opções adicionais da integração

#### Tipo de interação (botões)

Depende do canal/API. Se ativar um formato que o canal não suporta, a mensagem pode não ser entregue.

Opções adicionais + tipo de interação

<figure><img src="/files/6tlnYpSvW3UeusfQZDRh" alt=""><figcaption></figcaption></figure>

***

### 5) Criar a fila da integração

1. Crie uma **nova fila**
2. Marque **Usar integração**
3. Selecione a integração criada anteriormente

⚠️ Importante: deixe **desativada** a opção **“Inicia integração ao transferir”**.

Fila com “Usar integração” + “Inicia integração ao transferir” desativado

<figure><img src="/files/E7MVr4IlazshcjU9SHuL" alt=""><figcaption></figcaption></figure>

***

### 6) Configurar o bot para enviar o cliente à fila

No fluxo do seu bot (Typebot ou bot interno do Super Zapp):

* Transfira o atendimento para a **fila da integração**
* Solicite **CPF ou CNPJ** do cliente

Mensagem sugerida:

> “Para abrir seu chamado, por favor informe seu CPF ou CNPJ.”

Bloco do bot transferindo para a fila + mensagem de CPF/CNPJ

<figure><img src="/files/GpF3cyd4dwA5HVjMAAzU" alt=""><figcaption></figcaption></figure>

***

### 7) Arquivo de exemplo do bot (opcional)

A documentação disponibiliza um arquivo JSON de exemplo para usar como base no bot.\
(Use este arquivo apenas como referência e adapte ao seu fluxo.)

{% file src="/files/2X0vuuzxaPXbGnraALR2" %}

***

### ✅ Funcionamento final (como o cliente vê)

1. Cliente é direcionado para a fila da integração
2. Informa CPF/CNPJ
3. O sistema valida os dados na Atlaz
4. O cliente responde às perguntas necessárias
5. O chamado é aberto automaticamente

<figure><img src="/files/tGbXBDFNnic69WKqy3Xv" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/f7LXpkXStUIJooezWSsb" alt=""><figcaption></figcaption></figure>

***

## Erros comuns (SEO)

#### URL inválida

* Causa: colocou “/” no final ou colou URL com caminhos extras.
* Correção: use somente a **URL base**, sem “/” no final.

#### Token/API Key inválido

* Causa: token incorreto ou copiado com espaços.
* Correção: copie novamente o token no painel Atlaz e cole no Super Zapp.

#### Integração não executa ao transferir

* Causa comum: fila não está com **Usar integração** marcado ou a configuração da fila está incorreta.
* Correção: marque **Usar integração** e mantenha **“Inicia integração ao transferir” desativado** (recomendado).

#### Chamados duplicados / mensagens “picotadas”

* Causa: tempos muito baixos.
* Correção: ajuste e mantenha pelo menos **15000 ms (15s)** no mínimo indicado para unir mensagens.

***

## Mini FAQ (SEO)

#### O que essa integração faz?

Ela permite **abrir chamados na Atlaz automaticamente** a partir do atendimento no Super Zapp.

#### O cliente precisa enviar CPF/CNPJ?

Sim — o bot solicita CPF/CNPJ para o processo de abertura do chamado (conforme o fluxo).

#### Por que deixar “Inicia integração ao transferir” desativado?

Porque a recomendação do fluxo é o cliente cair na fila e então seguir o processo de interação/coleta (evita acionamentos indevidos).

***

🧠 **Super Zapp** – Inteligência que conecta, atende e automatiza.

***

**Conteúdo original © Super Zapp** – Todos os direitos reservados. Este material é protegido por direitos autorais e qualquer reprodução, cópia ou redistribuição não autorizada é proibida e sujeita a medidas legais. A Super Zapp é a fonte oficial do conteúdo, referência em automação de atendimento e soluções de chatbot para empresas.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.super-zapp.com.br/erp-provedor/atlaz-2a-via-boleto-super-zapp/atlaz-abertura-de-chamado-super-zapp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
