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

# Integrando no WhatsApp via Z-API

> Guia passo a passo para conectar seu agente ao WhatsApp utilizando a Z-API

# Integrando o Super Agentes ao WhatsApp via Z-API

Este guia explica como conectar seu agente do Super Agentes ao WhatsApp utilizando a Z-API, permitindo que seu agente interaja com usuários diretamente pelo WhatsApp.

<Warning>
  A Z-API é uma alternativa não oficial para integração com WhatsApp. Existe o risco de que números conectados através de APIs não oficiais possam ser banidos pelo WhatsApp. Use por sua conta e risco.
</Warning>

## Visão Geral

A Z-API é uma solução que facilita a integração com WhatsApp sem necessidade de aprovação da Meta ou processo de verificação de negócio. Esta é uma das várias opções disponíveis no Super Agentes para conectar seu agente ao WhatsApp, junto com a API oficial da Meta e a Evolution API.

## Pré-requisitos

* Uma conta no Super Agentes
* Um agente configurado no Super Agentes
* Uma conta na Z-API com uma instância configurada
* Um número de WhatsApp para conectar ao seu agente

## Configurando a Z-API

Antes de conectar seu agente ao WhatsApp, você precisa configurar uma instância na Z-API:

1. Acesse sua conta na Z-API
2. No menu lateral esquerdo, clique em **Instâncias da Web**
3. Selecione uma instância existente ou crie uma nova
4. Escaneie o QR Code exibido usando seu WhatsApp (vá em **Configurações > Dispositivos Conectados > Conectar um Dispositivo**)
5. Aguarde a confirmação da conexão

## Conectando seu Agente ao WhatsApp

### Passo 1: Acessar a Configuração de WhatsApp no Super Agentes

1. Acesse seu agente no Super Agentes
2. Vá para a aba **Ambientes**
3. Clique em **WhatsApp**
4. Clique em **Adicionar Conta**

### Passo 2: Selecionar a Z-API

1. No modal de conexão, selecione **Z-API** na lista de opções
2. Você verá dois campos para preencher:
   * **API da instância**
   * **Token de segurança da conta**

### Passo 3: Obter a API da Instância

1. Na sua conta da Z-API, vá para **Instâncias da Web**
2. Selecione a instância que você deseja conectar
3. Copie a **API da instância** exibida
4. Cole este valor no campo **API da instância** no Super Agentes

### Passo 4: Obter o Token de Segurança

1. Na sua conta da Z-API, vá para a seção **Segurança**
2. Se você ainda não tem um token, gere um novo
3. Copie o **Token de segurança da conta**
4. Cole este valor no campo **Token de segurança da conta** no Super Agentes

### Passo 5: Gerar o Webhook

1. Após preencher os campos, clique em **Gerar Webhook**
2. O Super Agentes gerará um URL de webhook
3. Copie o URL do webhook exibido

### Passo 6: Configurar o Webhook na Z-API

1. Volte para sua conta na Z-API
2. Vá para a instância que você está conectando
3. Clique em **Editar**
4. Vá para a seção **WebHooks**
5. Selecione a opção **Ao receber**
6. Cole o URL do webhook que você copiou do Super Agentes
7. Clique em **Salvar**

### Passo 7: Finalizar a Configuração

1. Volte para o Super Agentes
2. Clique em **Finalizar**
3. Pronto! Seu agente agora está conectado ao WhatsApp via Z-API

## Verificando a Conexão

Para verificar se a conexão foi estabelecida corretamente:

1. Envie uma mensagem para o número de WhatsApp conectado
2. Seu agente deve responder automaticamente
3. Você também pode verificar o status da conexão na aba **Ambientes > WhatsApp**

## Solução de Problemas

### Webhook Não Funcionando

Se o webhook não estiver funcionando corretamente:

1. Verifique se o URL do webhook foi copiado corretamente
2. Certifique-se de que a opção **Ao receber** está selecionada na Z-API
3. Verifique se a instância está ativa e conectada

### Erro de Autenticação

Se você receber erros de autenticação:

1. Verifique se a API da instância está correta
2. Confirme se o token de segurança está válido e foi copiado corretamente
3. Tente gerar um novo token de segurança e atualizar a configuração

### Conexão Perdida

Se a conexão com o WhatsApp for perdida:

1. Verifique o status da instância na Z-API
2. Se necessário, escaneie o QR Code novamente na Z-API
3. Após reconectar na Z-API, verifique se o webhook ainda está configurado corretamente

## Limitações e Considerações

* A Z-API é uma solução não oficial e não é endossada pela Meta (Facebook)
* Existe o risco de que números conectados através de APIs não oficiais possam ser banidos pelo WhatsApp
* Recomenda-se usar um número dedicado para seu agente, não seu número pessoal

## Perguntas Frequentes

**P: É possível conectar múltiplos agentes ao mesmo número de WhatsApp?**\
R: Não, cada número de WhatsApp só pode ser conectado a um agente por vez.

**P: A Z-API é gratuita?**\
R: A Z-API é um serviço pago. Consulte o site oficial para informações sobre preços.

**P: Quais tipos de mensagens meu agente pode enviar e receber?**\
R: Seu agente pode enviar e receber mensagens de texto, imagens, áudios e documentos.

**P: É possível usar a API oficial do WhatsApp em vez da Z-API?**\
R: Sim, o Super Agentes também oferece integração com a API oficial do WhatsApp Business. Essa opção requer aprovação da Meta e um processo de verificação de negócio. Consulte nossa [documentação de integração com WhatsApp oficial](/agent/integration/whatsapp) para mais informações.

**P: Qual a diferença entre Z-API e Evolution API?**\
R: Ambas são soluções não oficiais para integração com WhatsApp. A Z-API é um serviço pago com interface amigável, enquanto a Evolution API é de código aberto e pode ser hospedada por você mesmo. Consulte nossa [documentação da Evolution API](/agent/integration/evolution-api) para mais informações.