OPT Juntos
  1. Mensagens
OPT Juntos
  • OPT waba
    • Como enviar mensagens
    • Mensagens
      • Áudio
        POST
      • Contato
        POST
      • Documento
        POST
      • Imagem
        POST
      • Interativa com chamada para ação (URL)
        POST
      • Interativa com lista
        POST
      • Interativa com botões
        POST
      • Localização
        POST
      • Figurinha
        POST
      • Texto
        POST
      • Vídeo
        POST
      • Reação
        POST
      • Confirmação de leitura
        POST
    • Modelos de mensagens
      • Texto
      • Imagem
      • Documento
      • Vídeo
      • Botões
      • Lista
      • Localização
      • Código OTP
    • Mídia
      • Obter mídia
  • OPT Bot
    • send message to bot
      GET
  1. Mensagens

Figurinha

POST
https://waba.optjuntos.com.br/api/v1/messages

🧩 Mensagens de Figurinha (Sticker)#

As mensagens de figurinha (sticker) permitem que você envie adesivos animados ou estáticos para os seus clientes, adicionando um elemento visual e divertido às conversas.
Exemplo de mensagem com reação no WhatsApp

Limitações#

Tamanho máximo do arquivo: 100KB para figurinhas estáticas, 500KB para figurinhas animadas
Formato: WebP para figurinhas estáticas, WebP animado para figurinhas animadas
Dimensões: 512x512 pixels

Requisitos técnicos para figurinhas#

Figurinhas estáticas#

Formato: WebP
Dimensões: 512x512 pixels
Tamanho máximo: 100KB
Fundo transparente

Figurinhas animadas#

Formato: WebP animado
Dimensões: 512x512 pixels
Tamanho máximo: 500KB
Fundo transparente
Duração recomendada: 3-5 segundos

Boas práticas#

Otimize suas figurinhas para se adequarem aos limites de tamanho
Use figurinhas com fundo transparente para melhor integração
Crie figurinhas que comuniquem claramente a mensagem desejada
Certifique-se de que a URL da figurinha seja HTTPS e publicamente acessível
Use figurinhas apropriadas ao contexto da conversa

Casos de uso comuns#

Respostas rápidas e visuais
Expressão de emoções ou reações
Confirmação de ações ou recebimento
Elementos visuais para instruções ou avisos
Criar engajamento e tornar as conversas mais divertidas

Erros comuns#

CódigoMensagem de erroSolução
131055Media upload errorVerifique se a URL é válida e acessível
131056Media file too largeReduza o tamanho do arquivo
131057Media file format not supportedUse o formato WebP

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Bodyapplication/json

Exemplo
{
    "messaging_product": "whatsapp",
    "recipient_number": "{{recipient_number}}",
    "sticker": {
        "link": "https://example.com/stickers/happy.webp"
    }
}

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://waba.optjuntos.com.br/api/v1/messages' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messaging_product": "whatsapp",
    "recipient_number": "5517991677564",
    "sticker": {
        "link": "https://example.com/stickers/happy.webp"
    }
}'

Respostas

🟢200OK
application/json
✅ Sticker enviado com sucesso
Body

Exemplo
{
    "messaging_product": "whatsapp",
    "contacts": [
        {
            "input": "5511999999999",
            "wa_id": "5511999999999"
        }
    ],
    "messages": [
        {
            "id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFDNFQjBGQkZFOEVDRTMzMzM1QTgA"
        }
    ]
}
🟠400Pedido inválido
🟠401Não autorizado
🔴500Erro do servidor
Modificado em 2025-04-08 06:59:33
Página anterior
Localização
Próxima página
Texto
Built with