Skip to main content
För att använda våra API:er behöver du ha ett konto i Eldra. Mejla oss gärna på [email protected] så hjälper vi dig igång.

Välkommen till Eldras API-dokumentation

Här hittar du allt du behöver för att bygga en egen integration med Eldra. Vi samarbetar gärna med partners som vill koppla ihop sina system med vårt – på ett tryggt och smidigt sätt. Vill du komma igång med en integration? Hör av dig till oss på [email protected]

Integration mot ditt system

Eldra kan koppla upp sig mot vilket affärs- eller planeringssystem som helst.
För att komma igång behövs bara två API-gränssnitt i systemet du vill integrera med:
Eldra synkar kundregistret från systemet varje natt. På så sätt finns alltid rätt kunder tillgängliga – uppdaterade och klara.Vi förväntar oss en lista tillbaka med följande data (namnen på attributen kan skilja sig):
[{
	"name": "string", // Can be firstName, lastName as well
	"phonenumber": "string",
	"id": "string", // Can be integer as well. Will be used when calling back into integrating system
	"street": "string",
	"city": "string",
	"postalCode": "string",
	"unitIdentifier": "string", // Identification for which unit (sv. "Enhet" / "Område") the client belongs to. 
}]
Eldra hämtar schemat för en kund när ett samtal startar. Schemat ska vara uppdaterat så att kunden alltid får rätt information.Vi skickar in följande parametrar (det går också bra att skicka dem som queryparametrar):
{
	"startDate": Date, // start date for schedule range, e.g right now
	"endDate": Date, // end date for schedule range, e.g in three days
	"clientId": "string", // Or number
}
Svarslistan bör innehålla följande data:
[{
	"startDate": Date, // start date and time for scheduled appointment
	"endDate": Date, // end date and time for scheduled appointment
	"type": "string", // name of task, e.g. "Hemmets skötsel"
	"by": "string", // name of the person scheduled to do the task
	"status": "string" // indicating if the appointment is cancelled or active
}]
För att underlätta vardagen för personalen kan Eldra också anropa följande gränssnitt
Efter ett samtal mellan en klient och Eldra kan en arbetsanteckning automatiskt skapas i ert system. Det gör att personalen kan fortsätta arbeta i samma vy som vanligt.Eldra kan också skapa anteckningar på begäran under ett samtal med personal.Följande data skickas in:
{
	"message": "string" // the actual working note
	"by": "string" // either Eldra, or the staff name
	"clientId": "string" // Or number
}
Under samtal med personal kan Eldra svara på frågor om era rutiner och processer.Exempelvis vad man gör om ingen öppnar dörren, hur man hanterar en punktering – eller hur man sjukanmäler sig.Vi förväntar oss att kunna hämta materialet som filer eller text, via API-anrop eller nedladdningsbara länkar.

Datastruktur

Här beskriver vi hur data struktureras i Eldra – för att underlätta samarbeten och integrationer.
Det här är den grundläggande datamodellen som behövs för att Eldra ska fungera. Det är inte all data som finns i systemet, men tillräckligt för att du ska kunna komma igång.
EntitetBeskrivningBehöver Entitet
OrganisationDen övergripande enheten där allt hänger ihop
PortalEnhet i organisationen där kunder och konton kopplas inOrganisation
ClientRepresenterar en kund (brukare)Portal
AccountRepresenterar en användare (personal)Portal, Organisation
PhoneCallEtt samtal mellan kund eller användare och Eldra AIClient / Account
PhoneCallTranscriptLineVarje meddelande från kund eller användare och Eldra AIPhoneCall

Autentisering

Kom igång

Alla anrop kräver två HTTP-headrar för autentisering. Vi rekommenderar också att du sätter Content-Type för bästa upplevelse.
X-Portal-Id: '{portalId}'
Authorization: 'Bearer {token}'
Content-Type: 'application/json'
**X-Portal-Id **
ID för den portal som anropet gäller. Du hittar alla ID:n du har tillgång till via /me eller under Inställningar på https://app.eldra.ai/settings
Authorization:
Standardheader för autentisering.
Token kan skapas under Inställningar i gränssnittet.
Till vänster ser du en lista över alla våra gränssnitt.Klicka på det du vill utforska för att läsa mer.