DROPE API

Body (obrigatório)

• number — Destinatário
• type — Tipo (image, video, document, audio, myaudio, ptt, ptv, sticker)
• file — URL ou Base64

Body (opcional)

• text — Caption (aceita placeholders)
• docName — Nome do arquivo (document)
• thumbnail — Thumb (video/document)
• mimetype — MIME (opcional)
• replyid, mentions, delay, readchat, readmessages
• forward, track_source, track_id, async, placeholders

Dica: em delay, o WhatsApp pode exibir “Digitando...” ou “Gravando áudio...”.

Exemplo (imagem)

{
    "number": "5511999999999",
    "type": "image",
    "file": "https://site.com/imagem.jpg",
    "text": "Legenda opcional"
}

Exemplo (documento com nome)

{
    "number": "5511999999999",
    "type": "document",
    "file": "https://exemplo.com/contrato.pdf",
    "docName": "Contrato.pdf",
    "text": "Segue o documento solicitado"
}

Body (obrigatório)

• number — Destinatário
• fullName — Nome completo
• phoneNumber — Telefones (separados por vírgula)

Body (opcional)

• organization, email, url
• replyid, mentions, delay, readchat, readmessages
• forward, track_source, track_id, async

Exemplo

{
    "number": "5511999999999",
    "fullName": "João Silva",
    "phoneNumber": "5511999999999,5511888888888",
    "organization": "Empresa XYZ",
    "email": "joao.silva@empresa.com",
    "url": "https://empresa.com/joao"
}

Body (obrigatório)

• number — Destinatário
• latitude — Latitude (-90 a 90)
• longitude — Longitude (-180 a 180)

Body (opcional)

• name — Nome do local
• address — Endereço
• replyid, mentions, delay, readchat, readmessages
• forward, track_source, track_id, async

Exemplo

{
    "number": "5511999999999",
    "name": "MASP",
    "address": "Av. Paulista, 1578 - Bela Vista, São Paulo - SP",
    "latitude": -23.5616,
    "longitude": -46.6562
}

Body (obrigatório)

• number — Destinatário
• presence — composing, recording, paused

Body (opcional)

• delay — Duração em ms (máximo 300000ms)

Exemplo (digitando 30s)

{
    "number": "5511999999999",
    "presence": "composing",
    "delay": 30000
}

Exemplo (gravando 1 min)

{
    "number": "5511999999999",
    "presence": "recording",
    "delay": 60000
}

Exemplo (cancelar presença)

{
    "number": "5511999999999",
    "presence": "paused"
}

Body (obrigatório)

• type — text, image, video, audio, myaudio, ptt

Body (opcional)

• text — Texto/legenda (máx. 656 no texto)
• background_color — Cor de fundo (apenas type=text)
• font — Fonte (apenas type=text)
• file — URL/Base64 (image/video/audio)
• thumbnail, mimetype
• delay, async, track_source, track_id

Cores de fundo (ex.): 7-9 azul, 10-12 lilás, 17-19 cinza (19 padrão).

Exemplo (texto)

{
    "type": "text",
    "text": "Novidades chegando!",
    "background_color": 7,
    "font": 1
}

Exemplo (imagem)

{
    "type": "image",
    "text": "Promoção de hoje!",
    "file": "https://example.com/banner.jpg"
}

Body (obrigatório)

• number — Destinatário
• text — Texto exibido

Body (opcional)

• delay, readchat, readmessages, replyid, mentions
• forward, track_source, track_id, async

Nota: o botão de localização é adicionado automaticamente à mensagem.

Exemplo

{
    "number": "5511999999999",
    "text": "Para continuar o atendimento, clique no botão abaixo e compartilhe sua localização"
}

Body (obrigatório)

• number — Destinatário
• amount — Valor (BRL por padrão)

Body (opcional)

• title, text, footer
• itemName, invoiceNumber
• pixKey, pixType, pixName
• paymentLink — URL externa para checkout (se habilitado)
• fileUrl, fileName — Anexo (ex.: boleto PDF)
• boletoCode — Linha digitável (habilita boleto)
• delay, readchat, readmessages, replyid, mentions
• track_source, track_id, async

Dica: se você informar boletoCode, o método boleto é habilitado automaticamente.

Exemplo (Pix + valor)

{
    "number": "5511999999999",
    "title": "Detalhes do pedido",
    "text": "Pedido #123 pronto para pagamento",
    "footer": "Loja Exemplo",
    "itemName": "Assinatura Plano Ouro",
    "invoiceNumber": "PED-123",
    "amount": 59.90,
    "pixType": "EVP",
    "pixKey": "123e4567-e89b-12d3-a456-426614174000",
    "pixName": "Loja Exemplo"
}

Exemplo (boleto + PDF)

{
    "number": "5511999999999",
    "title": "Fatura",
    "text": "Segue seu boleto para pagamento",
    "amount": 199.90,
    "boletoCode": "34191.79001 01043.510047 91020.150008 5 91070026000",
    "fileUrl": "https://cdn.exemplo.com/boleto-123.pdf",
    "fileName": "boleto-123.pdf"
}

Body (obrigatório)

• number — Destinatário
• pixType — CPF, CNPJ, PHONE, EMAIL, EVP
• pixKey — Chave Pix

Body (opcional)

• pixName — Nome do recebedor (padrão “Pix”)
• delay, readchat, readmessages, replyid, mentions
• track_source, track_id, async

Exemplo

{
    "number": "5511999999999",
    "pixType": "EMAIL",
    "pixKey": "financeiro@empresa.com",
    "pixName": "Loja Exemplo"
}

Body (obrigatório)

• number — Destinatário
• type — button, list, poll, carousel
• text — Texto principal
• choices — Opções (formato depende do type)

Body (opcional)

• footerText — Rodapé (botões/listas)
• listButton — Texto do botão (listas)
• selectableCount — Qtde selecionável (poll)
• imageButton — Imagem (botões)
• delay, readchat, readmessages, replyid, mentions
• track_source, track_id, async

Exemplo (type: button)

{
    "number": "5511999999999",
    "type": "button",
    "text": "Como podemos ajudar?",
    "choices": [
      "Suporte Técnico|suporte",
      "Fazer Pedido|pedido",
      "Nosso Site|https://exemplo.com",
      "Falar Conosco|call:+5511999999999"
        ],
    "footerText": "Escolha uma das opções abaixo"
}

Exemplo (type: list)

{
    "number": "5511999999999",
    "type": "list",
    "text": "Catálogo de Produtos",
    "choices": [
      "[Eletrônicos]",
      "Smartphones|phones|Últimos lançamentos",
      "Notebooks|notes|Modelos 2024",
      "[Acessórios]",
      "Fones|fones|Bluetooth e com fio",
      "Capas|cases|Proteção para seu device"
        ],
    "listButton": "Ver Catálogo",
    "footerText": "Preços sujeitos a alteração"
}

Exemplo (type: poll)

{
    "number": "5511999999999",
    "type": "poll",
    "text": "Qual horário prefere para atendimento?",
    "choices": [
      "Manhã (8h-12h)",
      "Tarde (13h-17h)",
      "Noite (18h-22h)"
        ],
    "selectableCount": 1
}

Exemplo (type: carousel)

{
    "number": "5511999999999",
    "type": "carousel",
    "text": "Conheça nossos produtos",
    "choices": [
      "[Smartphone XYZ\nO mais avançado smartphone da linha]",
      "{https://exemplo.com/produto1.jpg}",
      "Copiar Código|copy:PROD123",
      "Ver no Site|https://exemplo.com/xyz",
      "Fale Conosco|call:+5511999999999",
      "[Notebook ABC\nO notebook ideal para profissionais]",
      "{https://exemplo.com/produto2.jpg}",
      "Copiar Código|copy:NOTE456",
      "Comprar Online|https://exemplo.com/abc",
      "Suporte|call:+5511988888888"
        ]
}

Body (obrigatório)

• number — Destinatário
• text — Texto principal
• carousel — Array de cards

Card (obrigatório)

• text — Texto do card
• image — URL da imagem
• buttons — Botões do card

Botões

• type — REPLY, URL, COPY, CALL
• text — Texto exibido
• id — Valor do botão (resposta, url, cupom, telefone)

Campos comuns (opcional)

• delay, readchat, readmessages, replyid, mentions
• forward, track_source, track_id, async

Exemplo completo

{
    "number": "5511999999999",
    "text": "Nossos Produtos em Destaque",
    "carousel": [
          {
    "text": "Smartphone XYZ\nO mais avançado smartphone da linha",
    "image": "https://exemplo.com/produto1.jpg",
    "buttons": [
              { "id": "SIM_COMPRAR_XYZ", "text": "Comprar Agora", "type": "REPLY" },
              { "id": "https://exemplo.com/xyz", "text": "Ver Detalhes", "type": "URL" }
            ]
    },
          {
    "text": "Cupom de Desconto\nGanhe 20% OFF em qualquer produto",
    "image": "https://exemplo.com/cupom.jpg",
    "buttons": [
              { "id": "DESCONTO20", "text": "Copiar Cupom", "type": "COPY" },
              { "id": "5511999999999", "text": "Falar com Vendedor", "type": "CALL" }
            ]
    }
        ],
    "delay": 0,
    "readchat": true
}