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

# Início Rápido do PanÐá Zap: Envie sua Primeira Mensagem em Minutos

> Conecte seu primeiro canal do WhatsApp, gere uma chave de API e envie sua primeira mensagem pela API REST do PanÐá Zap em cinco passos.

Siga estes cinco passos para sair de uma conta PanÐá Zap recém-criada até enviar sua primeira mensagem de WhatsApp pela API.

<Steps>
  <Step title="Entre no seu painel">
    Abra a URL do seu painel PanÐá Zap em um navegador e faça login com suas credenciais. Se você acabou de criar sua conta, verifique sua caixa de entrada em busca do e-mail de boas-vindas com o link de acesso.

    Depois de entrar, você chegará ao **Dashboard**, onde é possível ver a atividade de todos os seus canais conectados.
  </Step>

  <Step title="Conecte um canal do WhatsApp">
    Vá em **Configurações → Canais** e clique em **+ Novo Canal**, depois selecione **WhatsApp**.

    O PanÐá Zap suporta dois modos de conexão:

    | Modo                               | Melhor para                                                                                                                                                                                            |
    | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
    | **QR Code**                        | Configuração rápida usando uma conta do WhatsApp já existente no seu celular. Escaneie o QR Code exibido no painel com o aplicativo do WhatsApp para vincular o número instantaneamente.               |
    | **API Oficial do WhatsApp (WABA)** | Configuração de nível de produção, compatível com as políticas, via uma Conta Comercial aprovada pela Meta. Requer um Gerenciador de Negócios do Facebook verificado e um número de telefone aprovado. |

    Escolha o modo mais adequado ao seu caso de uso, preencha as etapas na tela e aguarde até que o status do canal exiba **Conectado**.
  </Step>

  <Step title="Crie uma chave de API">
    Vá em **Configurações → API** e clique em **+ Nova API**.

    Dê um nome descritivo à chave (por exemplo, `minha-primeira-integracao`) e confirme. O PanÐá Zap exibirá dois valores — copie-os agora, pois o token Bearer é mostrado apenas uma vez:

    | Valor            | Onde você vai usá-lo                         |
    | ---------------- | -------------------------------------------- |
    | **Token Bearer** | Cabeçalho `Authorization` em cada requisição |
    | **ID da API**    | Parte da URL da requisição                   |

    Sua URL base para todas as chamadas de API é:

    ```text theme={null}
    https://{BaseUrl}/v2/api/external/{ApiID}/
    ```

    Substitua `{BaseUrl}` pelo domínio do seu painel e `{ApiID}` pelo ID da API que você acabou de copiar.
  </Step>

  <Step title="Envie sua primeira mensagem">
    Com suas credenciais em mãos, faça a seguinte requisição para enviar uma mensagem de texto a um número do WhatsApp.

    <Note>
      Para canais de **API Oficial do WhatsApp (WABA)**, você deve usar um template de mensagem aprovado pela Meta para iniciar uma nova conversa. O campo `body` usado no exemplo abaixo serve para enviar **respostas em texto livre dentro de uma janela ativa de 24 horas** (ou seja, depois que o contato falou com você primeiro). Se você estiver usando um canal por QR Code, o campo `body` funciona para mensagens de saída sem restrição.
    </Note>

    <CodeGroup>
      ```bash cURL theme={null}
      curl --request POST \
        --url "https://{BaseUrl}/v2/api/external/{ApiID}" \
        --header "Authorization: Bearer {BearerToken}" \
        --header "Content-Type: application/json" \
        --data '{
          "body": "Olá! Sua primeira mensagem do PanÐá Zap.",
          "number": "5511999999999",
          "externalKey": "primeira-mensagem-001"
        }'
      ```

      ```json Corpo da Requisição theme={null}
      {
        "body": "Olá! Sua primeira mensagem do PanÐá Zap.",
        "number": "5511999999999",
        "externalKey": "primeira-mensagem-001"
      }
      ```
    </CodeGroup>

    **Campos da requisição**

    | Campo         | Tipo   | Descrição                                                                                                                                                                                         |
    | ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | `body`        | string | O conteúdo de texto da mensagem.                                                                                                                                                                  |
    | `number`      | string | Número de telefone de destino no formato E.164, sem o sinal `+` (por exemplo, `5511999999999` para um número brasileiro).                                                                         |
    | `externalKey` | string | Uma chave de idempotência única que **você** gera para cada envio. Nunca reutilize o mesmo valor para mensagens diferentes — o PanÐá Zap usa essa chave para evitar envios duplicados acidentais. |

    Uma resposta bem-sucedida se parece com isto:

    ```json Resposta theme={null}
    {
      "success": true,
      "data": {
        "message": "Message sent successfully",
        "ticketId": 123
      }
    }
    ```

    Salve o `ticketId` retornado na resposta — é o identificador único desta conversa e é necessário para chamadas de API seguintes, como enviar mensagens de acompanhamento ou atualizar o status do ticket.
  </Step>

  <Step title="Confira a mensagem na sua caixa de entrada">
    Volte ao seu painel e abra a tela de **Caixa de Entrada**. Você deverá ver uma nova conversa (ticket) criada para o número que você mandou mensagem, com a mensagem enviada visível na conversa.

    A partir daqui você pode responder manualmente, atribuir o ticket a um membro da equipe ou continuar automatizando a conversa pela API usando o `ticketId` recebido.

    🎉 **Prontinho!** Você conectou um canal, gerou uma chave de API e enviou sua primeira mensagem com o PanÐá Zap.
  </Step>
</Steps>