Ir para o conteúdo
WACore api
Entrar
CódigoPython

Enviar WhatsApp com Python (requests, sem SDK)

Não precisa de SDK: a API é HTTP puro. Esses 15 linhas com requests resolvem envio, e menos de 30 resolvem o webhook de entrada com validação de assinatura HMAC.

Por que usar a API própria nesse caso

SDK de terceiro amarra você à versão de outra pessoa. HTTP direto com requests funciona em Flask, FastAPI, Django e script de linha de comando, sem dependência nova.

Passo a passo

  1. Instale só o necessário: pip install requests.
  2. Guarde a chave em variável de ambiente (WACORE_KEY), nunca no código versionado.
  3. Poste em /v1/messages/text com o corpo instance, number, text e trate 429 com espera.
  4. Para receber, use Flask ou FastAPI e valide o header de assinatura antes de processar o corpo.

Exemplo de código

import os, time, requests

KEY = os.environ["WACORE_KEY"]
API = "https://wacoreapi.zapboot.com/v1"

def enviar(numero: str, texto: str, instancia: str = "principal"):
    numero = "".join(c for c in numero if c.isdigit())
    for tentativa in range(3):
        r = requests.post(
            f"{API}/messages/text",
            headers={"apikey": KEY},
            json={"instance": instancia, "number": numero, "text": texto},
            timeout=15,
        )
        if r.status_code == 429:          # fila cheia: espera e tenta de novo
            time.sleep(5 * (tentativa + 1))
            continue
        r.raise_for_status()
        return r.json()
    raise RuntimeError("fila recusou após 3 tentativas")

print(enviar("5511999999999", "Olá do Python!"))

Duas dicas que evitam retrabalho

  • Use requests.Session() para reaproveitar conexão: enviar 200 mensagens fica bem mais rápido com keep-alive.
  • Número só com dígitos e DDI. Se o seu banco guarda (11) 99999-9999, converta antes de chamar.
Contrato da API: todos os campos, códigos de erro e limites estão em /api. Se você precisa do mesmo endpoint em outra linguagem, a chamada é a mesma — muda só o cliente HTTP.

Como contratar

A contratação é sob consulta. Descreva o cenário (quantos números, volume e qual sistema integra) e receba a proposta com prazo de instalação e chave de API.

Ver planos