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

# Exemplos

> Exemplos executáveis do SDK .NET da VZaps no GitHub

O repositório oficial do SDK .NET inclui projetos de exemplo executáveis que espelham os fluxos documentados neste guia.

## Repositório no GitHub

Todos os exemplos ficam na pasta [`examples/`](https://github.com/VZaps/vzaps-sdk-dotnet/tree/main/examples):

**[github.com/VZaps/vzaps-sdk-dotnet](https://github.com/VZaps/vzaps-sdk-dotnet)**

Os projetos de exemplo consomem o pacote NuGet publicado (`VZaps.SDK`). O sample de console executa fluxos numerados de `01` a `11`.

Veja o [`examples/README.md`](https://github.com/VZaps/vzaps-sdk-dotnet/blob/main/examples/README.md) no repositório para a lista completa de projetos.

## O que está incluído

| Projeto                     | Tema                          |
| --------------------------- | ----------------------------- |
| `VZaps.Examples.Console`    | Fluxos numerados `01` a `11`  |
| `VZaps.Examples.Worker`     | Worker realtime via WebSocket |
| `VZaps.Examples.AspNetCore` | Integração com ASP.NET Core   |

Fluxos do console:

| Argumento | Tema                                  |
| --------- | ------------------------------------- |
| `01`      | Autenticação e listagem de instâncias |
| `02`      | Criar instância                       |
| `03`      | Assinatura e billing                  |
| `04`      | Sessão e pareamento                   |
| `05`      | Configuração de webhook               |
| `06`      | Assinatura realtime                   |
| `07`      | Enviar mensagem de texto              |
| `08`      | Mídia e mensagens interativas         |
| `09`      | Enquete, reação e ações de chat       |
| `10`      | Filas                                 |
| `11`      | TypeBot e Chatwoot                    |

## Opção A — só o sample de console (recomendado)

Você **não** precisa clonar o repositório inteiro do SDK.

1. Baixe apenas [`VZaps.Examples.Console`](https://github.com/VZaps/vzaps-sdk-dotnet/tree/main/examples/VZaps.Examples.Console) com **Download ZIP** no GitHub, ou execute:

```bash theme={null}
npx --yes degit VZaps/vzaps-sdk-dotnet/examples/VZaps.Examples.Console vzaps-dotnet-console
cd vzaps-dotnet-console
```

2. Configure as credenciais e execute um fluxo:

```bash theme={null}
export VZAPS_CLIENT_TOKEN=seu-client-token
export VZAPS_CLIENT_SECRET=seu-client-secret
export VZAPS_INSTANCE_ID=VZ...
export VZAPS_INSTANCE_TOKEN=token-da-instancia
dotnet run -- 07
```

## Opção B — sparse checkout

```bash theme={null}
git clone --depth 1 --filter=blob:none --sparse https://github.com/VZaps/vzaps-sdk-dotnet.git
cd vzaps-sdk-dotnet
git sparse-checkout set examples/VZaps.Examples.Console
cd examples/VZaps.Examples.Console
dotnet run -- 07
```

## Opção C — clone completo do repositório

```bash theme={null}
git clone https://github.com/VZaps/vzaps-sdk-dotnet.git
cd vzaps-sdk-dotnet/examples/VZaps.Examples.Console
dotnet run -- 07
```

Ao desenvolver o SDK localmente, substitua a referência NuGet por uma referência de projeto para `src/VZaps.SDK/VZaps.SDK.csproj`.

## Próximos passos

* Siga o [Guia inicial](/pt-BR/sdk/dotnet/starter-guide) para um passo a passo completo.
* Veja [Mensagens](/pt-BR/sdk/dotnet/messages) para todos os tipos de envio.