Dokumentation

SMS API Meddelanden

Inkommande SMS

Konfigurera ett virtuellt nummer och ta emot inkommande SMS som säkra callback-anrop.

För att ta emot SMS behöver kontot ett virtuellt nummer. När en callback-URL är konfigurerad skickar iP.1 inkommande meddelanden dit med POST.

Förutsättningar

Beställ ett abonnemang eller tillägg för virtuellt nummer.
Öppna användarportalen.
Gå till SMS-inställningarna för inkommande SMS.
Ange en absolut HTTPS-URL som callback.

Callbacken ska svara 200 OK när meddelandet tagits emot. Annan status leder enligt den publicerade dokumentationen till ett senare omförsök.

Exempel på payload

{
  "id": "message_in_abc123",
  "batchId": "batch_in_abc123",
  "owner": "ip1-XXXXX",
  "sender": "46700000000",
  "recipient": "46760000000",
  "body": "Ja, tiden passar.",
  "direction": "mo",
  "segments": 1,
  "type": "sms",
  "datacoding": "GSM",
  "priority": 1,
  "statuses": [
    {
      "created": "2026-10-05T08:03:21Z",
      "code": 201,
      "duration": 1
    }
  ],
  "modified": "2026-10-05T08:03:21Z",
  "mcc": "240",
  "mnc": "01"
}

Fält

Fält	Typ	Beskrivning
`id`	`string`	Det inkommande meddelandets ID.
`batchId`	`string`	Överliggande batch.
`owner`	`string`	Kontot som äger det virtuella numret.
`sender`	`string`	Mobilnumret som skickade SMS:et.
`recipient`	`string`	Ditt virtuella nummer.
`body`	`string`	Meddelandets innehåll.
`direction`	`string`	`mo` (Mobile Originated).
`segments`	`integer`	Antal SMS-segment.
`type`	`string`	Meddelandetyp.
`datacoding`	`string`	`gsm` eller `ucs`. Den äldre dokumentationen råkade benämna Unicode-alternativet `flash`; korrekt term i övriga API-referensen är `ucs`.
`priority`	`integer`	Meddelandets prioritet.
`statuses`	`object[]`	Statushändelser.
`modified`	`string`	Senaste uppdatering i ISO 8601.
`mcc`	`string \| null`	Mobile Country Code när tillgängligt.
`mnc`	`string \| null`	Mobile Network Code när tillgängligt.

Implementationsråd

svara först när payloaden validerats och säkert lagts i kö
gör mottagaren idempotent med id
behandla body som data, aldrig som HTML eller kod
sätt gränser för payload och behandlingstid
minimera lagring av telefonnummer och meddelandetext
skapa larm för upprepade callback-fel

Behöver du läsa en sammanhängande historik för en deltagare kan du använda konversations-endpoints.