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

# Exemplos práticos

> Fluxos reais para integração com a EZ API.

## Criar instância e enviar texto

```bash theme={null}
curl -X POST 'https://api.ezapi.com.br/instances' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Instância produção"}'
```

```bash theme={null}
curl -X POST \
  'https://api.ezapi.com.br/instances/abc1234567890/token/tok_a1b2c3d4e5f6/send-text' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Mensagem enviada pela EZ API"
  }'
```

## Enviar mídia com legenda

```bash theme={null}
curl -X POST \
  'https://api.ezapi.com.br/instances/abc1234567890/token/tok_a1b2c3d4e5f6/send-image' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "image": "https://cdn.example.com/banner.png",
    "caption": "Arquivo enviado pela automação"
  }'
```

## Validar números antes do disparo

```bash theme={null}
curl -X POST \
  'https://api.ezapi.com.br/instances/abc1234567890/token/tok_a1b2c3d4e5f6/phone-exists-batch' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phones": ["5511999999999", "5511888888888"]
  }'
```

## Configurar webhooks principais

```bash theme={null}
curl -X PUT \
  'https://api.ezapi.com.br/instances/abc1234567890/token/tok_a1b2c3d4e5f6/update-webhook-received' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"value":"https://example.com/webhooks/received"}'
```

```bash theme={null}
curl -X PUT \
  'https://api.ezapi.com.br/instances/abc1234567890/token/tok_a1b2c3d4e5f6/update-webhook-message-status' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"value":"https://example.com/webhooks/message-status"}'
```

## Criar grupo e ajustar permissões

```bash theme={null}
curl -X POST \
  'https://api.ezapi.com.br/instances/abc1234567890/token/tok_a1b2c3d4e5f6/create-group' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "groupName": "Time comercial",
    "phones": ["5511999999999", "5511888888888"]
  }'
```

```bash theme={null}
curl -X POST \
  'https://api.ezapi.com.br/instances/abc1234567890/token/tok_a1b2c3d4e5f6/update-group-settings' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "120363123456789-group",
    "adminOnlyMessage": true,
    "adminOnlySettings": true,
    "requireAdminApproval": false,
    "adminOnlyAddMember": true
  }'
```