Prezentare generală
API-ul Amovio este un API REST cu răspunsuri JSON. Este același API pe care îl folosește dashboard-ul de pe amovio.ro, deci fiecare acțiune din aplicație are un endpoint corespunzător. Lista completă de endpoint-uri e în secțiunea API Reference. Pentru integrările proprii, punctul de intrare recomandat este webhook-ul de lead-uri: îl apelezi din site-ul tău sau din orice formular, cu o cheie API, fără autentificare de utilizator.URL de bază
/v1.
Autentificare
Endpoint-urile pentru datele firmei cer o sesiune de utilizator Amovio, trimisă ca token în header-ulAuthorization:
Resurse principale
Webhook pentru lead-uri
Trimite lead-uri din site-ul tău, din landing page-uri sau din alte platforme direct în CRM-ul Amovio.Cheia API
Mergi la Setări → Webhooks. Pagina Webhook Lead-uri îți arată cheia API a firmei (începe cupk_). Copiaz-o cu butonul de lângă ea.
Request
<adresa-showroom> este adresa publică a showroom-ului, aleasă la înregistrare.
Ce se întâmplă cu lead-ul
- Dacă există deja un lead cu același telefon sau email, Amovio nu creează un duplicat: adaugă mesajul ca notă pe lead-ul existent.
- Dacă trimiți
carId, lead-ul se asignează automat agentului de vânzare al mașinii, care primește notificarea. - Fără
carIdsau fără agent pe mașină, lead-ul intră neasignat și echipa e anunțată conform preferințelor de notificare.
duplicate: true înseamnă că mesajul a fost atașat unui lead existent, cu ID-ul din leadId.
Erori
Erorile au același format pe toate endpoint-urile:Acțiunile costisitoare sau care consumă cote externe (trimiterea la ANAF, generarea de PDF-uri, exporturile, formularele publice) au limite de frecvență proprii. Când primești
429, așteaptă înainte să reîncerci, nu repeta cererea în buclă.