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

# Enviar sticker

> Envie uma figurinha estática ou animada.

Envia uma figurinha (sticker), estática ou animada, para um cliente com a [janela de 24 horas](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#janela-de-24-horas) aberta.

> [!NOTE]
>
> O destinatário pode ser informado pelo **número de telefone** (`to`) ou pelo **ID do usuário** (`recipient`). Se os dois forem enviados, vale o `to`; para enviar pelo ID do usuário, deixe o `to` em branco. Veja a diferença em [Destinatário](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#destinatário).

## Link ou ID da mídia

Informe a figurinha de uma das duas formas:

| Campo | Quando usar | Como conseguir |
| - | - | - |
| `sticker.link` | A figurinha está em uma URL pública. | Envie o arquivo na aba **Mídias** do número, no [painel da Datafy](https://app.datafyapi.com.br). O link gerado vale por **30 dias**. |
| `sticker.id` | Você já enviou o arquivo para a Meta. | Use o `id` retornado pelo endpoint [Upload de mídia](https://developers.datafyapi.com.br/api-reference/whatsapp/recursos/midia/upload-de-midia.md). |

> [!WARNING]
>
> **Envie apenas um dos dois.** Com `link` e `id` na mesma requisição, a Meta recusa o envio.

No **Testar**, o `link` já vem preenchido com uma figurinha animada de exemplo. Para testar com um `id`, apague o `link` antes de enviar.

## Formatos aceitos

As figurinhas precisam estar no formato **WebP**:

| Tipo | Extensão | Tipo MIME | Tamanho máximo |
| - | - | - | - |
| Figurinha estática | `.webp` | `image/webp` | 100 KB |
| Figurinha animada | `.webp` | `image/webp` | 500 KB |

Mensagens de sticker não têm legenda.

Veja mais detalhes na [documentação de mensagens de sticker da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/sticker-messages).


## OpenAPI

````yaml api-reference/whatsapp/specs/sticker.json POST /v1/{phone_number_id}/messages
openapi: 3.1.0
info:
  title: Datafy API — Enviar sticker
  version: 1.0.0
servers:
  - url: https://cloud.datafyapi.com.br
    description: Produção
security:
  - bearerAuth: []
paths:
  /v1/{phone_number_id}/messages:
    post:
      summary: Enviar sticker
      operationId: enviarSticker
      parameters:
        - name: phone_number_id
          in: path
          required: true
          schema:
            type: string
          description: ID do número que envia a mensagem. Descubra com `GET /me`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MensagemSticker'
            example:
              messaging_product: whatsapp
              recipient_type: individual
              to: '5511999999999'
              type: sticker
              sticker:
                link: https://files2.datafychats.com.br/sticker.webp
      responses:
        '200':
          description: Envio aceito pela Meta. Não confirma a entrega.
          content:
            application/json:
              example:
                messaging_product: whatsapp
                contacts:
                  - input: '5511999999999'
                    wa_id: '5511999999999'
                messages:
                  - id: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA=
        '400':
          description: Erro retornado pela Meta, como enviar `id` e `link` juntos.
          content:
            application/json:
              example:
                error:
                  message: >-
                    (#132018) There’s an issue with the parameters in your
                    template
                  type: OAuthException
                  code: 132018
                  error_data:
                    messaging_product: whatsapp
                    details: Only one of media ID or link must be present
                  fbtrace_id: AbCdEfGhIjK
        '401':
          description: Token ausente ou inválido.
          content:
            application/json:
              example:
                statusCode: 401
                message: Token inválido ou não encontrado.
components:
  schemas:
    MensagemSticker:
      type: object
      required:
        - messaging_product
        - to
        - type
        - sticker
      properties:
        messaging_product:
          type: string
          enum:
            - whatsapp
          default: whatsapp
          example: whatsapp
          description: Sempre `whatsapp`.
        recipient_type:
          type: string
          enum:
            - individual
          default: individual
          example: individual
          description: Sempre `individual`.
        to:
          type: string
          example: '5511999999999'
          description: >-
            Número do destinatário com código do país e DDD, como
            `5511999999999`. Tem prioridade sobre `recipient`: para enviar pelo
            ID do usuário, deixe em branco.
        recipient:
          type: string
          description: >-
            ID do usuário no WhatsApp (BSUID), recebido nos webhooks em
            `from_user_id` e `contacts[].user_id`, como
            `BR.13491208655302741918`. Usado quando `to` não é informado.
        type:
          type: string
          enum:
            - sticker
          default: sticker
          example: sticker
          description: Sempre `sticker`.
        sticker:
          type: object
          description: >-
            Figurinha da mensagem, em WebP. Informe `link` **ou** `id`, nunca os
            dois.
          properties:
            link:
              type: string
              description: >-
                URL pública da figurinha `.webp`. Você pode gerar um link na aba
                **Mídias** do número, no painel da Datafy. Não envie junto com
                `id`.
              example: https://files2.datafychats.com.br/sticker.webp
            id:
              type: string
              description: >-
                ID da mídia retornado pelo endpoint **Upload de mídia**. Não
                envie junto com `link`.
        context:
          type: object
          description: Responde citando uma mensagem anterior da conversa.
          properties:
            message_id:
              type: string
              description: ID (`wamid`) da mensagem que será citada.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token gerado no painel da Datafy ao criar o canal. Formato:
        `sk_live_xxx`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.