Introducere
WhatsApp Business API îți permite să automatizezi conversațiile cu clienții pe WhatsApp, cea mai populară platformă de mesagerie din lume.
Beneficii:
- Acces la 2+ miliarde utilizatori WhatsApp
- Rate de deschidere 98%+ (vs. 20% email)
- Suport multimedia (imagini, video, documente)
- Verificare oficială (marca verde)
WhatsApp Business API este diferit de aplicația WhatsApp Business. API-ul necesită un Business Solution Provider (BSP).
Cerințe preliminare
1. Cont Facebook Business Manager
- Crează un cont pe business.facebook.com
- Verifică identitatea afacerii
2. Număr de telefon dedicat
- Nu poate fi folosit pe WhatsApp personal
- Trebuie să poată primi SMS pentru verificare
3. Business Solution Provider Bravin AI recomandă:
- Twilio
- MessageBird
- 360Dialog
Procesul de verificare Facebook durează 3-5 zile lucrătoare.
Configurare furnizor
Pasul 1: Înregistrare la BSP Alege un furnizor și creează cont. Pentru Twilio:
Nu partaja niciodată credențialele Twilio public sau în cod frontend!
TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_PHONE_NUMBER=+1234567890Pasul 2: Conectare cu Bravin
În panoul Bravin AI, mergi la Integrations → WhatsApp:
{
"provider": "twilio",
"accountSid": "ACxxxxxx...",
"authToken": "xxxxxx...",
"phoneNumber": "+1234567890",
"webhookUrl": "https://api.bravin.ai/webhooks/whatsapp"
}Configurare webhooks
Webhooks sunt esențiale pentru recepționarea mesajelor în timp real.
În consola Twilio:
- Mergi la Phone Numbers → Active Numbers
- Selectează numărul WhatsApp
- La "When a message comes in", setează:
Bravin AI procesează automat toate mesajele primite și le rutează către agentul AI.
https://api.bravin.ai/webhooks/whatsapp/YOUR_ACCOUNT_IDTemplate-uri mesaje
WhatsApp necesită template-uri aprobate pentru inițierea conversațiilor (primele 24h).
Creează un template:
- Mergi la WhatsApp → Message Templates
- Click Create Template
- Definește nume, categorie, limbă
- Adaugă conținut cu variabile
Template-urile sunt revizuite de WhatsApp în 24-48 ore. Asigură-te că respectă politicile lor.
Bună {{1}}! 👋
Comanda ta #{{2}} a fost confirmată și va ajunge în {{3}} zile.
Ai întrebări? Scrie-ne oricând!Testare integrare
1. Test mesaj inbound
- Trimite un mesaj WhatsApp către numărul conectat
- Verifică în Dashboard → Conversations
- Ar trebui să vezi mesajul și răspunsul agentului
2. Test mesaj outbound
- Folosește un template aprobat
- Trimite din Dashboard către numărul tău
- Verifică primirea și formatarea
Testează cu 3-5 conversații complete înainte de a anunța clienții.
Bune practici
1. Respectă fereastra de 24h
- După mesajul clientului, ai 24h pentru răspunsuri gratuite
- Apoi trebuie să folosești template-uri
2. Opt-in explicit
- Obține permisiunea clienților pentru WhatsApp
- Oferă opțiune de opt-out
3. Monitorizează rating-ul
- WhatsApp Rating trebuie > 80% (High Quality)
- Sub 80% = warning, sub 60% = restricții
4. Răspunde rapid
- Target: < 5 minute pentru prima interacțiune
- Foloseșteagentul AI pentru disponibilitate 24/7
Încălcarea politicilor WhatsApp poate duce la suspendarea permanentă a contului.