Para enviar uma mensagem de WhatsApp com Python, faça um POST com {type, text} para a API da Blueticks, com a sua chave no cabeçalho. A mensagem sai do seu próprio número de WhatsApp. Sem biblioteca especial, só requests.
Um aviso, porque a busca costuma dizer "WhatsApp Business API": isto não é a API em nuvem da Meta. É uma API que envia pelo seu número, vinculado como um dispositivo do WhatsApp Web. A seção sobre riscos explica o que isso significa.
Criar minha chave de APIEm dev.blueticks.co, abra a página de chaves e crie uma. Ela começa com bt_live_ e é um token bearer: trate como senha e guarde só no servidor.
Vincule o seu WhatsApp à conta em app.blueticks.co/connections, pela extensão com o WhatsApp Web aberto ou por um Gateway na nuvem.
O número de quem vai receber, com + e código do país, sem espaços nem traços, por exemplo +5511999999999.
Para confirmar que a chave e o número estão certos antes do primeiro envio, chame GET https://api.blueticks.co/v1/ping. A resposta traz o id da conta e as conexões de WhatsApp ativas. Se a lista vier vazia, não há WhatsApp conectado e os envios não saem.
curl https://api.blueticks.co/v1/ping \ -H "Authorization: Bearer bt_live_SUA_CHAVE_AQUI"
Faça um POST para https://api.blueticks.co/v1/scheduled-messages/{destino} com a chave no cabeçalho Authorization. O destino vai no caminho da URL. Sem o campo sendAt, a mensagem sai na hora.
import requests
API_KEY = "bt_live_SUA_CHAVE_AQUI"
DESTINO = "+5511999999999" # formato E.164, vai no caminho da URL
resp = requests.post(
f"https://api.blueticks.co/v1/scheduled-messages/{DESTINO}",
headers={"Authorization": f"Bearer {API_KEY}"},
json={"type": "text", "text": "Olá, enviado pelo Python"},
timeout=30,
)
resp.raise_for_status()
msg = resp.json()["data"] # respostas de sucesso vêm em {"success": true, "data": {...}}
print(msg["id"], msg["status"])O que o esquema da API exige, conferido no nosso backend:
type é obrigatório e deve ser text, media ou poll. Um corpo só com {"text": "..."} é rejeitado.text, o campo text é obrigatório e tem no máximo 4.096 caracteres.id da mensagem, que você usa depois para consultar o status. Os dados ficam dentro de data.O mesmo guia, com cURL e Node, está em inglês em enviar uma mensagem de WhatsApp por API.
Adicione sendAt ao mesmo corpo. É uma data e hora ISO 8601 com fuso, com pelo menos 10 segundos no futuro e no máximo 365 dias. A Blueticks coloca a mensagem na fila do lado dela, então o seu script não precisa continuar rodando.
from datetime import datetime, timedelta, timezone
import requests
enviar_em = (datetime.now(timezone.utc) + timedelta(hours=2)).isoformat()
resp = requests.post(
"https://api.blueticks.co/v1/scheduled-messages/+5511999999999",
headers={"Authorization": "Bearer bt_live_SUA_CHAVE_AQUI"},
json={"type": "text", "text": "Lembrete: ligação às 16h", "sendAt": enviar_em},
timeout=30,
)
resp.raise_for_status()
print(resp.json()["data"]["status"])O endereço é o mesmo, só muda o corpo. Para um PDF: {"type": "media", "mediaUrl": "https://exemplo.com/recibo.pdf", "mediaKind": "document"}. A URL da mídia precisa ser https. Para uma enquete: {"type": "poll", "pollQuestion": "...", "pollOptions": ["A", "B"]}.
O plano gratuito permite 5 solicitações de API a cada 6 horas, compartilhadas com a integração MCP. Qualquer assinatura paga ativa não tem limite de solicitações. Confira os valores atuais na página de preços antes de planejar em cima de um número.
Sobre o computador desligado: se o seu número está vinculado pela extensão, o envio acontece enquanto aquela sessão do navegador estiver online. Um Gateway, o motor hospedado na nuvem do plano Pro, continua enviando com o computador desligado.
bt_live_ envia mensagens como você. Guarde-a no servidor, fora do git, e revogue na página de chaves se ela vazar.Não. A Blueticks não usa a API em nuvem da Meta. Ela envia a partir do seu próprio número, por um dispositivo vinculado do WhatsApp Web, pela extensão no navegador ou por um Gateway na nuvem. Se você precisa da plataforma oficial da Meta para empresas, é outro produto.
Sim. Você cria uma chave bt_live_ em dev.blueticks.co e a envia no cabeçalho Authorization como token bearer. Você também precisa vincular um número de WhatsApp à sua conta da Blueticks uma vez.
Sim. Troque o corpo por {"type": "media", "mediaUrl": "https://exemplo.com/arquivo.pdf", "mediaKind": "document"}. A URL da mídia precisa ser https.
Sim. Use {"type": "poll", "pollQuestion": "...", "pollOptions": ["A", "B"]} no mesmo endereço.
Só se o seu número rodar na nuvem. Com a extensão da Blueticks, o envio acontece enquanto aquela sessão do navegador estiver online. Um Gateway, o motor hospedado na nuvem do plano Pro, continua enviando com o computador desligado. O endereço /v1/ping informa cada conexão como gateway ou regular.
O plano gratuito permite 5 solicitações de API a cada 6 horas, compartilhadas com a integração MCP. Qualquer assinatura paga ativa não tem limite de solicitações. Veja a página de preços para os valores atuais antes de planejar em cima de um número.
Não podemos prometer que o WhatsApp nunca vai restringir um número. Escreva para pessoas que esperam receber a sua mensagem, mantenha o volume moderado e lembre que o consentimento e a opção de sair são responsabilidade sua.
Dados conferidos em 18 de novembro de 2026. Veja também: preços, API REST de WhatsApp no seu próprio número (em inglês), servidor MCP de WhatsApp.