Skip to main content

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ă

Toate rutele au prefixul de versiune /v1.

Autentificare

Endpoint-urile pentru datele firmei cer o sesiune de utilizator Amovio, trimisă ca token în header-ul Authorization:
Token-ul identifică atât utilizatorul, cât și firma. Nu trimite niciodată un ID de firmă în request: fiecare cerere vede doar datele firmei din care face parte utilizatorul autentificat. Permisiunile urmează rolul utilizatorului (Admin, Manager, Agent, Financiar). Vezi Utilizatori și roluri.
Un utilizator dezactivat nu mai poate apela API-ul, chiar dacă are încă un token emis înainte.

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 cu pk_). Copiaz-o cu butonul de lângă ea.
Tratează cheia ca pe o parolă. Folosește-o doar din serverul tău, nu în codul JavaScript al unei pagini publice.

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ă carId sau fără agent pe mașină, lead-ul intră neasignat și echipa e anunțată conform preferințelor de notificare.
Răspuns:
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ă.