Current information for our partners

Here we collect current and important information for partners.

Aktuellt partner

Tre viktiga förändringar i Kivras sender API

2023-11-28

Vi vill uppmärksamma er på att Kivra kommer införa 3 viktiga förändringar i sender API, enligt nedan.

  1. 31a maj 2024 kommer vi stänga v1/tenant/TENANT_ID/content och ber alla som är integrerade mot Kivras API att istället använda v2/tenant/TENANT_ID/content
  2. I och med övergången till v2 blir attributen type and subject obligatoriska i metadatastrukturen för v2/tenant/TENANT ID/content
  3. Vi tar bort [payment] metadatastrukturen. Dess funktionalitet kommer att ersättas med den redan existerande [payment_multiple_options] metadatastrukturen

Exempel av betalning i v1 och v2 av content endpoint

NEW version of Kivras API!

To ensure that you, as a partner, send correctly and always have support for our new and upcoming services, we recommend planning a transition to Kivra's Content API v2.

We have launched version 2 of our API, and to this version, we have transferred the following features:

  • Responsive Design: Customize content based on the device it's displayed on. With HTML, we enable features like graphs, charts, dropdown menus, and carousels - a more sophisticated layout, in essence.
  • Forms: Create and send forms through our 'Forms' API and collect valuable information from users.
  • Email Matching: We now allow matching Kivra users based on email addresses, not just personal identification numbers as before.
  • Campaigns by Tag: The ability to target campaigns based on your sender's own segmentation.

This change was made due to limitations in v1's metadata structure. API v2 has a flatter and more flexible structure, making it easier to develop and enhance our services.

Currently, the above four services have already transitioned to API v2. Other services will gradually move from V1 to V2.

Kivra is now offering 'Campaigns by Tag'

2023-09-05

The option to add a Campaign tag when sending content through our API is now available in beta version. The sender needs to activate a new metadata field to enable the use of a Campaign tag.

The campaign is created by adding a tag in 'Campaigns'. When content is sent through Kivra's content-API and a tag is added to the new metadata field, Kivra links the campaign if there's a match. This tag segmentation will then replace all other options in 'Campaigns'.

For more information, contact us.

The opportunity to use incremental matching.

2021-10-03

We want to notify you of the opportunity to use so-called incremental matching for Kivra’s API. It means that you (integrator/partner to Kivra) who uses our API – and have the right to access our user database – can request to download the changes in our user base for a customer (sender) in comparison to the previous lookup. This instead of, as earlier, having to download the complete user database for each sender, each time.

Read more

For further questions please contact: partner@kivra.com

Kivra will shut down the opportunity for partners to integrate via BATCH.

2021-09-07

Batchintegrationen stängs ner 31 december 2022

Kivra har tagit beslut om att stänga ner all vår batch-integration. Det innebär att det – om en tid – inte längre kommer vara möjligt att exempelvis hämta user accept-filer eller skicka in filer till oss.

Varför görs förändringen?

Vi gör förändringen för att vi tillsammans med våra partners ska kunna introducera nya tjänster och funktionalitet som kräver realtidsinteraktion. Batch-lösningen är inte optimerad för det. Däremot stödjer Kivras API-tjänst nya funktioner till fullo.

Vad innebär det för partners?

För er som partner innebär det att ni behöver se över och förändra hela eller delar av er intergrationsuppsättning och istället övergå till vår API-tjänst. Vi förstår att det innebär extra arbete för er. Därför har vi satt en väl tilltagen deadline – 31 december, 2022.

Mer om förändringen

Det finns fler skäl till att vi överger batch-lösningen. Det primära att vi ökat vår utvecklingstakt på Kivra och flera betydande funktioner har inte fullt stöd i den äldre lösningen. En stor del av vår partner- och kundbas har redan gjort skiftet och vi vill såklart att ni ska ha samma förutsättningar att ta del av hela vårt produktutbud.

Frågor och plan för migrering?

Vi kommer vara behjälpliga med stöd för tekniska frågor under övergången. Vi bistår också gärna med en plan för er att migrera från batchlösningen till API-tjänsten. Frågor om övergången besvaras av er Partneransvarige. Ni hittar kontaktuppgifter till supporten längst ner på denna sida om ni behöver hjälp med att integrera via Kivras API.

Reminder on required API endpoint change

As announced already one year ago via kivrastatus.se and mail (https://kivrastatus.se/details/b01e178293096) partners and senders should use the following API endpoints to communicate via Kivra:

Partners and senders that have not updated the endpoint yet are required to proceed with the change as quickly as possible and no later than 31st October 2021.

For questions please contact partner@kivra.com or paolo.leva@kivra.com

LÄS MER HUR NI INTEGRERAR VIA API

Any questions?

For questions about how to integrate via our API, contact us here.