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
- Instale só o necessário: pip install requests.
- Guarde a chave em variável de ambiente (WACORE_KEY), nunca no código versionado.
- Poste em /v1/messages/text com o corpo instance, number, text e trate 429 com espera.
- 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.