liguelead-api

LigueLead API – Integration Skill

Overview

LigueLead is a Brazilian communications platform for voice, SMS, and RCS. This skill covers:

• Authentication via dual-header (api-token + app-id)
• Voice calls (2-step process: upload audio → send campaign)
• SMS (standard and Flash) in a single request
• RCS (template creation — text/media/card/carousel — then send)
• Webhooks for real-time campaign status

Base URL: https://api.liguelead.com.br/v1

---

1. Authentication

Every request requires two mandatory headers:

api-token: YOUR_API_TOKEN
app-id:    YOUR_APP_ID
Content-Type: application/json

Where to get them: LigueLead Dashboard → Integrações → API Token (areadocliente.liguelead.app.br)

⚠️ Never expose api-token or app-id in client-side code. Use environment variables.

---

2. Phone number format

The API accepts three Brazilian phone number formats:

Format	Example	Digits
National (recommended)	11999999999	11
International	+5511999999999	14 chars
DDI without +	5511999999999	13

Recommendation: use the national format (11 digits) for best compatibility.

---

3. Sending voice calls

Voice sending is a 2-step process.

Step 1 — Upload audio

POST /v1/voice/uploads — multipart/form-data

curl -X POST "https://api.liguelead.com.br/v1/voice/uploads" \
  -H "api-token: YOUR_API_TOKEN" \
  -H "app-id: YOUR_APP_ID" \
  -F "title=My Message" \
  -F "file=@/path/to/audio.mp3"

Response (201):

{
  "message": "Voice upload successful.",
  "data": {
    "id": 436514,
    "title": "My Message"
  }
}

Save the id — it's the voice_upload_id for the next step.

File limits:

• Supported formats: MP3 and WAV (AAC and M4A not supported)
• Max size: 50 MB (recommended: 5–10 MB)
• Storage per account: 10 GB | Max 1,000 active files