Enviar mensagem em massa

POST

https://wazap-ai-api.up.railway.app/external/v1/messages/send-bulk

Envia a mesma mensagem para múltiplos números de uma vez.

Limites:

Máximo de 100 contatos por requisição

Delays automáticos entre envios (anti-ban)

Anti-Ban:

Ordem dos contatos é randomizada por padrão

Delays de 3-8 segundos entre mensagens

Pausas maiores a cada 10 e 50 mensagens

Requisição

Authorization

API Key

Adicionar parâmetro em header

X-Company-Token

Exemplo:

X-Company-Token: ********************

API Key

Adicionar parâmetro em header

X-Account-Token

Exemplo:

X-Account-Token: ********************

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Envio em massa processado

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

cURL

Lista simples de númerosContatos com dados

curl --location 'https://wazap-ai-api.up.railway.app/external/v1/messages/send-bulk' \
--header 'X-Company-Token: <api-key>' \
--header 'X-Account-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "message": "Promoção especial! Confira nosso site.",
    "contacts": [
        "5511999999999",
        "5511888888888",
        "5511777777777"
    ]
}'

Response Example

200 - Exemplo 1

{
    "success": true,
    "message": "Envio em massa concluído: 10 enviadas, 0 erros, 2 inválidos",
    "data": {
        "batchUuid": "fc04296f-170f-455b-bff8-c6d7a5e9f76f",
        "summary": {
            "total": 12,
            "success": 10,
            "failed": 0,
            "invalid": 2
        },
        "results": [
            {
                "number": "string",
                "uuid": "string",
                "messageId": "string",
                "status": "string"
            }
        ],
        "errors": [
            {
                "number": "string",
                "error": "string",
                "message": "string"
            }
        ]
    }
}

Modificado em 2026-01-05 19:31:10

Página anterior

Enviar mensagem com mídia

Próxima página

Status de uma mensagem