# Enviar pack de figurinhas

`POST /send/sticker-pack`

Pasta: **Enviar Mensagem**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Enviar pack de figurinhas

Monta e envia um pacote de figurinhas (capa + stickers). Disponível apenas no modo web (companion).

## Endpoint

```http
POST {{baseUrl}}/send/sticker-pack
```

## Autenticação

Envie o token da instância no header:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| number | string | Sim* | Destinatário |
| chatid | string | Sim* | Alternativa a number |
| name | string | Sim | Nome do pack |
| publisher | string | Não | Editora/autor |
| description | string | Não | Descrição |
| cover.url / cover.base64 | string | Sim | Capa do pack |
| stickers | array | Sim | Lista de figurinhas |
| stickers[].url / base64 | string | Sim | Arquivo da figurinha |
| stickers[].emojis | string[] | Não | Emojis associados |
| stickers[].accessibility_label | string | Não | Rótulo de acessibilidade |
| stickers[].is_lottie | bool | Não | Figurinha Lottie |
| spoiler / ai / group_status / channel_status / external_ad_reply / ... | vários | Não | MessageExtras opcionais |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/send/sticker-pack" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"number": "{{remoteJid}}", "name": "Meu Pack", "publisher": "GoZAP", "description": "Figurinhas de demonstração", "cover": {"url": "https://exemplo.com/cover.webp"}, "stickers": [{"url": "https://exemplo.com/a.webp", "emojis": ["😀"]}, {"url": "https://exemplo.com/b.webp", "emojis": ["🔥"], "accessibility_label": "fogo"}]}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": {
    "id": "3EB0A1B2C3D4E5F6",
    "timestamp": "2026-07-17T12:34:56Z",
    "sender": "5511888888888@s.whatsapp.net"
  }
}
```

## Erros comuns

- `number or chatid is required`
- `sticker pack send is web-only (mobile does not support MediaStickerPack upload yet)`
- Falha ao baixar/converter capa ou stickers

## Observações

- Web-only: não funciona em instâncias no modo mobile de conexão.

## Corpo (exemplo)

```json
{
  "number": "{{remoteJid}}",
  "name": "Meu Pack",
  "publisher": "GoZAP",
  "description": "Figurinhas de demonstração",
  "cover": {
    "url": "https://exemplo.com/cover.webp"
  },
  "stickers": [
    {
      "url": "https://exemplo.com/a.webp",
      "emojis": [
        "😀"
      ]
    },
    {
      "url": "https://exemplo.com/b.webp",
      "emojis": [
        "🔥"
      ],
      "accessibility_label": "fogo"
    }
  ]
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/send/sticker-pack" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "{{remoteJid}}",
  "name": "Meu Pack",
  "publisher": "GoZAP",
  "description": "Figurinhas de demonstração",
  "cover": {
    "url": "https://exemplo.com/cover.webp"
  },
  "stickers": [
    {
      "url": "https://exemplo.com/a.webp",
      "emojis": [
        "😀"
      ]
    },
    {
      "url": "https://exemplo.com/b.webp",
      "emojis": [
        "🔥"
      ],
      "accessibility_label": "fogo"
    }
  ]
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=enviar-mensagem/enviar-pack-de-figurinhas)