En duplikatmelding er den andre og hver påfølgende melding med samme tekst sendt til samme nummer. Det skjer sjelden med vilje – oftere skyldes det at et API-kall gjentas etter et tidsavbrudd, et dobbeltklikk på en knapp eller at ett nummer havner flere ganger i mottakerlisten. BulkGate beskytter deg mot dette, men [transaksjonsruten og markedsføringsruten](https://www.bulkgate.com/no/hjelpesenter/generell-informasjon/forskjellen-mellom-markedsforings-og-transaksjonsmeldinger/) håndterer det forskjellig.

## Hvordan de to beskyttelsene skiller seg

|                    | Transaksjonsmelding                          | Markedsføringsmelding                   |
|:-------------------|:----------------------------------------------|:------------------------------------------|
| Hva den overvåker  | den samme meldingen gjentatt over tid        | dupliserte mottakere innenfor én liste  |
| Rekkevidde         | på tvers av forespørsler, et vindu på 5 minutter | bare innenfor én enkelt forespørsel  |
| Standardtilstand   | av                                            | av                                       |
| Hva du ser         | meldingen feiler med `duplicity_message`     | mottakeren forsvinner stille fra listen |

## Transaksjonsmeldinger: den samme meldingen gjentatt over tid

Du slår den på med parameteren `duplicates_check` i [transaksjons-API-et](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-transactional/2.0/) eller [det enkle transaksjons-API-et](https://www.bulkgate.com/no/dokumentasjon/simple-api/simple-transactional/). Den godtar `on` og `off` (den forstår også `true`/`false`, `1`/`0`, `yes`/`no`), og standardverdien er `off`.

Når den er slått på, husker BulkGate denne kombinasjonen for hver sendte melding:

| Del av fingeravtrykket  | Merknad                                                                         |
|:------------------------|:--------------------------------------------------------------------------------|
| Konto                   | gjelder på tvers av alle applikasjoner (`application_id`) under én lommebok    |
| Kanal                   | samme tekst via SMS og via Viber er to forskjellige meldinger                   |
| Telefonnummer           | i internasjonalt format                                                         |
| Meldingstekst           | må stemme tegn for tegn – et annet navn, klokkeslett eller en annen kode gjør den til en annen melding |

Kommer en melding med samme fingeravtrykk innen fem minutter, forkaster BulkGate den, og den når aldri operatøren.

> [!IMPORTANT]
> Femminuttersvinduet starter med den **første** meldingen, og forkastede forsøk forlenger det ikke. Når det er utløpt, går den samme meldingen gjennom igjen.

For en kaskademelding brukes hovedteksten i kaskaden i fingeravtrykket, ikke tekstene til de enkelte kanalene.

### Hva du ser i svaret

- **En enkeltmelding** – API-et returnerer feilen `duplicity_message` med koden `400`. Se listen over [feiltyper](https://www.bulkgate.com/no/dokumentasjon/api-administrasjon/api-feiltyper/).
- **En samlet transaksjonsmelding** – den forkastede meldingen får statusen `duplicity_message` og telles med i `total.status.duplicity_message`. Resten av satsen sendes som vanlig.

> [!CAUTION]
> Tenk deg om to ganger før du bruker beskyttelsen for engangspassord. Hvis koden endres ved hvert forsøk, slår den aldri inn. Sender du en fast tekst, forkaster du den andre sendingen innen fem minutter – og brukeren som trykket «Send på nytt», får ingen melding i det hele tatt.

## Markedsføringsmeldinger: dupliserte mottakere innenfor én sats

På markedsføringsruten huskes ingenting mellom forespørslene. BulkGate går ganske enkelt gjennom mottakerlisten fra én forespørsel før sending og beholder den første forekomsten. Parameteren `duplicates_check` i [markedsførings-API-et](https://www.bulkgate.com/no/dokumentasjon/advanced-api/advanced-promotional/2.0/) eller [det enkle markedsførings-API-et](https://www.bulkgate.com/no/dokumentasjon/simple-api/simple-promotional/) har tre verdier:

| Verdi         | Hva den fjerner                                              |
|:--------------|:-------------------------------------------------------------|
| `same_text`   | den samme meldingen gjentatt til det samme nummeret         |
| `same_number` | enhver ytterligere melding til det samme nummeret, selv med en annen tekst |
| ikke angitt   | ingenting – listen sendes nøyaktig slik du sendte den inn   |

> [!NOTE]
> Fjerningen skjer stille – svaret inneholder verken status eller teller for duplikater. Det eneste sporet er et lavere antall mottakere enn det du sendte inn. Blir ingen igjen etter fjerningen, feiler forespørselen med `no_recipients`.

To forespørsler etter hverandre ser ikke hverandre. Sender du samme mottaker i to satser, går begge meldingene ut.

## Kampanjer i portalen

En [kampanje](https://www.bulkgate.com/no/hjelpesenter/kampanjer/kampanjeoversikt/) går markedsføringsruten og kjører duplikatkontrollen selv – når mottakerlisten er satt sammen, viser den hvor mange den fant, under overskriften **Dupliser meldingsvarning**:

- **Samme nummer og samme tekst** – kampanjen fjerner alltid disse, uten noe valg.
- **Samme nummer, annen tekst** – her bestemmer du selv. Krysser du av for **Fjern duplikat mottakere**, får hvert nummer én enkelt melding; lar du det være, går alle ut.

I en A/B-testet kampanje fjernes dupliserte mottakere alltid, ellers ville én person fått flere testede varianter, og testresultatet ville vært verdiløst.

## Hva du bør passe på

- **Den samme parameteren betyr to forskjellige ting.** På transaksjonsruten er `duplicates_check` en bryter som beskytter på tvers av forespørsler over tid; på markedsføringsruten velger den en metode og gjelder bare innenfor én forespørsel.
- **Delt konto betyr delt vindu.** Flere integrasjoner under én lommebok kan forkaste hverandres meldinger hvis de sender de samme tekstene til de samme numrene.
- **En forkastet melding sendes ikke**, så den blir verken levert eller registrert blant sendte meldinger.
- **Sjekk antallene i svaret.** Markedsføringsruten rapporterer ingen fjerninger – sammenligner du leveringer med inndatalisten din, må du regne med forskjellen.