Documentatie MobileHandler

MobileHandler

Caller ID, SMS Gateway & VoIP Integration

Descarca APK Integrare VoIP

Ce face MobileHandler?

MobileHandler este o aplicatie Android care transforma telefonul intr-un gateway inteligent pentru apeluri si SMS, integrat cu platforma BAPP. Cand un client suna, aplicatia identifica automat clientul in baza de date si afiseaza informatii relevante (comenzi, contacte, lead-uri CRM) intr-un overlay pe ecranul de apel.

Caller ID

Identifica automat clientul care suna si afiseaza informatii din toate firmele din cont.

Overlay pe ecran

Informatii despre client afisate direct pe ecranul de apel, cu navigare catre comenzi si fisa client.

SMS Gateway

Trimite si primeste SMS-uri prin telefonul fizic, controlat din platforma BAPP via WebSocket.

Notificari in panel

Alertele de apel si SMS apar in panoul web BAPP cu informatii complete despre client si link-uri rapide.

Configurare

1

Descarca aplicatia

Descarca MobileHandler.apk si instaleaz-o pe telefonul Android.

2

Autentifica-te

Logheaza-te cu contul BAPP. Aplicatia va prelua automat lista de firme la care ai acces.

3

Configureaza

Din Setari, selecteaza firma de receptie, activeaza redirectionarea apelurilor si serviciul de fundal.

4

Acorda permisiunile

Permite accesul la telefon, SMS, afisare overlay si excludere de la optimizarea bateriei.

Integrare VoIP

Poti conecta furnizori VoIP externi (3CX, Asterisk, Twilio, etc.) pentru a primi notificari de apeluri si SMS direct in panoul BAPP, fara a folosi aplicatia Android.

Activare

  1. 1. In panoul BAPP, mergi la Setari firma → Mobile Handler
  2. 2. Activeaza Integrare VoIP
  3. 3. Copiaza URL-ul webhook si Token-ul de autorizare afisate
  4. 4. Configureaza URL-ul in panoul furnizorului VoIP ca destinatie pentru notificari de apel
  5. 5. Adauga token-ul in header-ul Authorization: Bearer <token> al fiecarui request
Autorizare obligatorie — Toate request-urile catre webhook trebuie sa contina token-ul de autorizare. Poti trimite token-ul in header-ul Authorization: Bearer <token> sau ca parametru query ?token=<token>. Token-ul se genereaza automat la prima accesare a setarilor si poate fi regenerat din butonul Regenereaza token VoIP.

Endpoint API

POST https://ipn.bapp.ro/voip/{company_uuid}/event
Authorization: Bearer {voip_auth_token}

Payload (JSON)

{
  "action": "incoming_call",
  "number": "+40712345678",
  "contact": "Ion Popescu"
}

Actiuni suportate

action Descriere
incoming_call Apel primit (arata overlay cu informatii client)
incoming_call_started Apelul a fost preluat
incoming_call_stopped Apelul s-a incheiat
incoming_call_missed Apel pierdut
state_incoming_sms SMS primit (include campul content cu textul mesajului)

Campuri payload

Camp Tip Descriere
action string Tipul evenimentului (default: incoming_call)
number string Numarul de telefon (obligatoriu). Accepta si phone sau from
content string Continutul SMS (doar pentru state_incoming_sms). Accepta si message sau body
contact string Numele contactului (optional)

Exemplu cURL

curl -X POST https://ipn.bapp.ro/voip/YOUR_COMPANY_UUID/event \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_VOIP_AUTH_TOKEN" \
  -d '{
    "action": "incoming_call",
    "number": "+40712345678",
    "contact": "Ion Popescu"
  }'