REST API v1

API Reference

Integre o Labby com qualquer sistema. Envie mensagens, gerencie contatos e automatize fluxos com nossa API REST completa.

Comece em 3 linhas

Envie sua primeira mensagem em segundos.

terminal
curl -X POST \
  https://api.labby.com.br/v1/messages/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "to": "5511999999999",
    "text": "Ola! Sua conta foi criada com sucesso."
  }'

Autenticacao

Todas as requisicoes devem incluir um token Bearer no header Authorization. Gere suas chaves API no painel administrativo.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx

Nunca exponha suas chaves API no frontend. Use sempre no lado do servidor.

Endpoints Principais

Tudo que voce precisa para integrar o Labby ao seu sistema.

Mensagens

Envie e gerencie mensagens em todos os canais.

POST/v1/messages/send
GET/v1/messages/{id}
GET/v1/messages
POST/v1/messages/bulk

Contatos

Gerencie sua base de contatos e segmentacoes.

POST/v1/contacts
GET/v1/contacts/{id}
GET/v1/contacts
PUT/v1/contacts/{id}

Bots

Crie, configure e monitore chatbots inteligentes.

POST/v1/bots
POST/v1/bots/{id}/deploy
GET/v1/bots/{id}/analytics
PUT/v1/bots/{id}/config

Campanhas

Crie e dispare campanhas multi-canal.

POST/v1/campaigns
POST/v1/campaigns/{id}/send
GET/v1/campaigns/{id}/report

Webhooks

Receba eventos em tempo real no seu sistema.

POST/v1/webhooks
GET/v1/webhooks
DELETE/v1/webhooks/{id}

Rate Limits

Os limites variam de acordo com seu plano. Requisicoes excedentes retornam HTTP 429.

Plano
Requisicoes
Mensagens
Starter
60 req/min
1.000 msg/dia
Growth
200 req/min
10.000 msg/dia
Pro
500 req/min
50.000 msg/dia
Enterprise
Custom
Ilimitado

SDKs Oficiais

Bibliotecas prontas para as principais linguagens.

Node.js

npm install @labby/sdk

Python

pip install labby
Em breve

PHP

composer require labby/sdk

Pronto para integrar?

Crie sua conta e gere sua primeira chave API em minutos.