API: Tilbuds- og e-mailskabeloner
Integratorer og AI-agenter kan oprette og redigere tilbudsskabeloner og e-mailskabeloner via REST API. Det understøtter fuld automatisering af tilbudsflow fra jeres egne systemer.
Artiklen er til udviklere der bygger tilbud, skabeloner eller e-mail-kampagner via API.
Forudsætninger
- API-nøgle med admin-scope til at oprette/redigere skabeloner
- Kendskab til tilbudsmotor-konceptet i Salesbase (Tilbudsmotorer i UI)
Tilbudsskabeloner
Endpoint: /api/v1/offer-templates
Skabeloner består af:
- pages[] med elementer (
text,heading,html,columns,line_items,totals,videom.fl.) - headerElements og footerElements (logo, firmainfo, sidetal)
- branding (farver, typografi)
Elementtypen html understøtter fri HTML med inline CSS til hero-bannere og infobokse. Placeholders som {{offer.number}} og {{recipient.name}} erstattes ved visning. columns lægger elementer side om side (fx 55/45).
E-mailskabeloner
Endpoint: /api/v1/email-templates
Send compiledHtml med HTML og sæt emne i metadata.subject. Placeholders: {{contact.firstName}}, {{company.name}}.
Fuldt tilbudsflow via API
- Opret produkter (
/api/v1/products) - Opret tilbudsmotor (
/api/v1/offer-types) meddefaultTemplateId - Opret tilbud (
/api/v1/offers) medcalculatorResult - Send tilbud (
POST /api/v1/offers/:id/send)
Fuld AI-reference: GET /api/v1/docs?section=offerTemplates
Resultat
Skabeloner og tilbud kan provisioneres fra CI/CD, partner-portaler eller AI-agenter uden manuel klik-opsætning i Indstillinger → Tilbud & Produkter.
Fejlsøgning
| Symptom | Løsning |
|---|---|
| 403 ved skabelon | Bekræft admin-scope på API-nøglen |
| HTML vises tomt | Valider html-element og placeholders |
| Send fejler | Tjek tilbudsmotor, modtager-email og produkter |