{"id":416,"date":"2023-11-23T11:17:20","date_gmt":"2023-11-23T10:17:20","guid":{"rendered":"http:\/\/localhost\/wordpress\/?page_id=416"},"modified":"2026-01-08T12:21:06","modified_gmt":"2026-01-08T12:21:06","slug":"conversations","status":"publish","type":"page","link":"https:\/\/ip1sms.com\/en\/developer\/conversations\/","title":{"rendered":"Conversations"},"content":{"rendered":"\n
\n
\n
\n\n\n\n

Konversationer<\/h1>\n\n\n\n

L\u00e4s meddelanden till och\/eller fr\u00e5n en tillhandah\u00e5llen deltagare.<\/p>\n\n\n\n

Quick start<\/h2>\n\n\n\n

Anv\u00e4nd exemplet nedan och byt ut \u201cAPI_NYCKEL\u201d mot en bearer token som du skapar i anv\u00e4ndarportalen samt byt ut {participant} mot ett nummer i formatet MSISDN (46712345678)<\/p>\n\n\n

\ncurl -X POST "https:\/\/api.ip1sms.com\/v2\/conversations\/{participant}" \\\n-H "Authorization: Bearer API_NYCKEL" \\\n-H "Content-Type: application\/json" \\\n<\/pre><\/div>\n\n\n
\n\n\n\n
Anrop<\/h2>\n\n\n\n
H\u00e4mta alla meddelanden<\/h3>\n\n\n\n
Denna endpoint l\u00e5ter dig h\u00e4mta samtliga meddelanden i en konversation, oavsett riktning, baserat p\u00e5 mottagaren eller avs\u00e4ndarens nummer.<\/p>\n\n\n\n
Endpoint: \/v2\/conversations\/{participant}<\/p>\n\n\n\n
Metod: GET<\/code><\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/conversations\/46712345678\n<\/pre><\/div>\n\n\n
H\u00e4mta alla utg\u00e5ende meddelanden<\/h3>\n\n\n\n
Denna endpoint l\u00e5ter dig h\u00e4mta utg\u00e5ende meddelanden i en konversation baserat p\u00e5 en angiven deltagare. mt<\/code> \u00e4r en akronym f\u00f6r mobile terminated.<\/p>\n\n\n\n
Endpoint: \/v2\/conversations\/{participant}\/mt<\/p>\n\n\n\n
Metod: GET<\/code><\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/conversations\/46712345678\/mt\n<\/pre><\/div>\n\n\n
H\u00e4mta alla inkommande meddelanden<\/h3>\n\n\n\n
Denna endpoint l\u00e5ter dig h\u00e4mta inkommande meddelanden i en konversation baserat p\u00e5 angiven deltagare. mo<\/code> \u00e4r en akronym f\u00f6r mobile originated.<\/p>\n\n\n\n
Endpoint: \/v2\/conversations\/{participant}\/mo<\/p>\n\n\n\n
Metod: GET<\/code><\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/conversations\/46712345678\/mo\n<\/pre><\/div>\n\n\n
H\u00e4mta en sammanfattning \u00f6ver meddelanden<\/h3>\n\n\n\n
F\u00f6rutom att l\u00e4sa meddelanden till och ett specifikt MSISDN (Mobilnummer) tillhandah\u00e5ller vi ocks\u00e5 en endpoint som ger dig en aggregerad summering f\u00f6r meddelanden separerat mellan mt <\/em>och mo<\/em><\/p>\n\n\n\n
Endpoint \/v2\/conversations\/{participant}\/summary<\/p>\n\n\n\n
Metod: GET<\/code><\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/conversations\/46712345678\/summary\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r anropsdata<\/h3>\n\n\n\n
\n  \n    \n      \n        \n      \n        
F\u00e4ltnamn<\/th>\n        Obligatorisk<\/th>\n        Typ<\/th>\n        Beskrivning och Villkor<\/th>\n        Exempel<\/th>\n      <\/tr>\n    <\/thead>\n    
participant<\/strong><\/td>\n        Ja<\/td>\n        String<\/code><\/td>\n        \n          En deltagares nummer i formatet MSISDN (46712345678).\n        <\/td>\n        \n          
\n46712345678\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n
\n\n\n\n
Respons<\/h2>\n\n\n\n
Responsdata f\u00f6r ett anrop till \/v2\/conversations\/{participant}\/mt<\/strong>, \/v2\/conversations\/{participant}\/mo<\/strong> samt \/v2\/conversations\/{participant}<\/strong> returnerar en paginerad lista likt respons-datan f\u00f6r listning av meddelanden.<\/p>\n\n\n\n
Exempel p\u00e5 responsdata (Meddelanden)<\/h3>\n\n\n
\n{\n    "id": "5bcf4324ee47dee41a9dbb13",\n    "batchId": "5bc86b6e85c7209830f96936",\n    "owner": "ip1-XXXXX",\n    "sender": "iP1",\n    "recipient": "456189040623",\n    "body": "Hi my name is earl",\n    "direction": "mt",\n    "segments": 1,\n    "type":"SMS",\n    "datacoding": "ucs",\n    "priority": 1,\n    "price": 0.0416,\n    "currency": "EUR",\n    "statuses": [\n        {\n            "created": "2018-10-23T17:43:21Z",\n            "code": 201,\n            "duration": 0\n        }\n    ],\n    "modified": "2018-10-23T17:43:19Z",\n    "reference": "A client reference",\n    "mcc": "431",\n    "mnc": "20"\n}\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r responsdata (Meddelanden)<\/h3>\n\n\n\n
\n  \n    \n      \n        \n      \n        \n        \n        \n        \n        \n        \n      \n        \n        \n        \n        \n        \n        \n        \n        \n        \n        
F\u00e4ltnamn<\/th>\n        Typ<\/th>\n        Beskrivning och Villkor<\/th>\n        Exempel<\/th>\n      <\/tr>\n    <\/thead>\n    
id<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Ett unikt id f\u00f6r ett detta specifika meddelande.\n        <\/td>\n        \n          
\n\"id\": \"5bcf4324ee47dee41a9dbb13\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
batchId<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Den \u00f6vergripande batchens id\n        <\/td>\n        \n          
\n\"batchId\": \"5bc86b6e85c7209830f96936\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
owner<\/strong><\/td>\n        String<\/code><\/td>\n        \n          SMS-kontots ID, \u00e4gare f\u00f6r det specifika meddelandet.\n        <\/td>\n        \n          
\n\"owner\": \"ip1-XXXXX\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
sender<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Avs\u00e4ndaren f\u00f6r meddelandet\n        <\/td>\n        \n          
\n\"sender\": \"iP1\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
recipient<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Mottagarens mobilnummer\n        <\/td>\n        \n          
\n\"recipient\": \"456189040623\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
body<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Sj\u00e4lva meddelandet\n        <\/td>\n        \n          
\n\"body\": \"Hi my name is earl\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n    
direction<\/strong><\/td>\n      String<\/code><\/td>\n      \n        Talar om ifall meddelandet skickades<\/strong> eller togs emot<\/strong> av v\u00e5rt system.\n        
    \n          
  • MT<\/code> En akronym f\u00f6r Mobile Terminated, ett meddelande som skickades till en mobil enhet.<\/li>\n          
  • MO<\/code> En akronym f\u00f6r Mobile Originated, ett meddelande som skickades fr\u00e5n en mobil enhet.<\/li>\n        <\/ul>\n      <\/td>\n      
\n \"direction\": \"MT\"\n      <\/code><\/pre><\/td>\n    <\/tr>\n      
segments<\/strong><\/td>\n        String<\/code><\/td>\n        \n          I de fall meddelandet best\u00e5r av fler tecken \u00e4n teckengr\u00e4nsen f\u00f6r ett SMS kommer meddelandet att delas upp i\n          flera SMS, \u00e4ven kallat konkatenerade SMS. Den h\u00e4r egenskapen indikerar om hur m\u00e5nga SMS som beh\u00f6vs f\u00f6r att\n          kunna skicka meddelandet\n        <\/td>\n        \n          
\n\"segments\": 1\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
datacoding<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Anger det minsta datakodningsschema som beh\u00f6vs f\u00f6r att skicka meddelandet i fr\u00e5ga. Om meddelandetexten\n          inneh\u00e5ller tecken utanf\u00f6r den angivna datakodningen skickas inte meddelandet, vilket den senaste statuskoden\n          ska visa. Detta kan skilja sig fr\u00e5n batchens datakodning.\n        <\/td>\n        \n          
\n\"datacoding\": \"ucs\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
priority<\/strong><\/td>\n        String<\/code><\/td>\n        Meddelandets prioritet. Prioritet 1 \u00e4r standardv\u00e4rdet och samtidigt den l\u00e4gsta prioritet som tillhandah\u00e5lls.\n          Prioritet 2 \u00e4r den h\u00f6gsta prioriteten.<\/td>\n        \n          
\n \"priority\": 1\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
price<\/strong><\/td>\n        String<\/code><\/td>\n        Hela meddelandets pris. Vill du veta priset f\u00f6r ett enskilt SMS i ett meddelande, kan du dela meddelandets\n          pris med antalet segment.<\/td>\n        \n          
\n \"price\": 0.0416\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
currency<\/strong><\/td>\n        String<\/code><\/td>\n        Vilken valuta som meddelandets pris anv\u00e4nder.<\/td>\n        \n          
\n  \"currency\": \"EUR\",\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
statuses<\/strong><\/td>\n        Array<\/code><\/td>\n        En lista best\u00e5ende av statusuppdateringar inneh\u00e5llandes den senaste statusen f\u00f6r varje meddelande.<\/td>\n        \n          
\n \"statuses\": [\n    {\n        \"created\": \"2018-10-23T17:43:21Z\",\n        \"code\": 201,\n        \"duration\": 0\n    }\n],\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
modified<\/strong><\/td>\n        String<\/code><\/td>\n        N\u00e4r SMS:et senast uppdaterades<\/td>\n        \n          
\n\"modified\": \"2018-10-23T17:43:19Z\",\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
reference<\/strong><\/td>\n        String<\/code><\/td>\n        Detta \u00e4r en egenskap som till\u00e5ter anv\u00e4ndaren att s\u00e4tta ett eget ID eller referens om lagring av\n          standard-genererade ID\u00b4n ogillas.<\/td>\n        \n          
\n\"reference\": \"A client reference\",\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
mcc<\/strong><\/td>\n        String<\/code><\/td>\n        Lands-delen av bladoperat\u00f6ren kan specificeras h\u00e4r om den tillhandah\u00e5lls av uppstr\u00f6ms-b\u00e4raren.\n          MCC\u00a0\u00e4r en akronym f\u00f6r Mobile Country Code\n        <\/td>\n        \n          
\n\"mcc\": \"431\",\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
mnc<\/strong><\/td>\n        String<\/code><\/td>\n        N\u00e4tverks-delen av bladoperat\u00f6ren kan specificeras h\u00e4r om den tillhandah\u00e5lls av uppstr\u00f6ms-b\u00e4raren.\n          MNC \u00e4r en akronym f\u00f6r Mobile Network Code\n        <\/td>\n        \n          
\n\"mnc\": \"20\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n
Exempel p\u00e5 responsdata (Sammanfattning)<\/h3>\n\n\n
\n{\n    "participant": "46734487112",\n    "totalMessageCount": 387,\n    "totalSmsCount": 774,\n    "mobileTerminatedMessages": {\n        "101": {\n            "messages": 43,\n            "sms": 86\n        },\n        "102": {\n            "messages": 3,\n            "sms": 6\n        },\n        "201": {\n            "messages": 142,\n            "sms": 284\n        }\n    },\n    "mobileOriginatedMessages": {\n        "201": {\n            "messages": 199,\n            "sms": 398\n        }\n    }\n}\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r responsdata (Sammanfattning)<\/h3>\n\n\n\n
\n  \n    \n      \n        \n      \n        \n        \n        \n        \n        
F\u00e4ltnamn<\/th>\n        Typ<\/th>\n        Beskrivning och Villkor<\/th>\n        Exempel<\/th>\n      <\/tr>\n    <\/thead>\n    
participant<\/strong><\/td>\n        String<\/code><\/td>\n        \n          En deltagare \u00e4r antingen ett MSISDN (Mobilnummer) eller en alfanumerisk avs\u00e4ndare (Textavs\u00e4ndare). Detta f\u00e4lt talar vilken typ av deltagare det handlar om.\n        <\/td>\n        \n          
\n\"participant\": \"46734487112\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
totalMessageCount<\/strong><\/td>\n        Integer<\/code><\/td>\n        \n        Den totala m\u00e4ngden meddelanden kopplade till deltagaren.\n        <\/td>\n        \n          
\n\"totalMessageCount\": 387\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
totalSmsCount<\/strong><\/td>\n        String<\/code><\/td>\n        \n        Den totala m\u00e4ngden SMS-segment kopplade till deltagaren.\n        <\/td>\n        \n          
\n\"totalSmsCount\": 774,\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
mobileTerminatedMessages<\/strong><\/td>\n        Nestat objekt<\/code><\/td>\n        \n          En summering av meddelanden som skickats till deltagaren. Summeringen best\u00e5r av en dictionary d\u00e4r nyckelen \u00e4r en statuskod och v\u00e4rdet \u00e4r en count \u00f6ver hur m\u00e5nga meddelanden (och meddelandets respektive SMS-segment) som har specifierad statuskod och som den senast tillagda statusen.\n        <\/td>\n        \n          
\n  \"mobileTerminatedMessages\": {\n      \"101\": {\n          \"messages\": 43,\n          \"sms\": 86\n      },\n      \"102\": {\n          \"messages\": 3,\n          \"sms\": 6\n      },\n      \"201\": {\n          \"messages\": 142,\n          \"sms\": 284\n      }\n  },\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
mobileOriginatedMessages<\/strong><\/td>\n        Nestat objekt<\/code><\/td>\n        \n        En summering av meddelanden som skickats fr\u00e5n deltagaren. Summeringen best\u00e5r av en dictionary d\u00e4r nyckelen \u00e4r en statuskod och v\u00e4rdet \u00e4r en count \u00f6ver hur m\u00e5nga meddelanden (och meddelandets respektive SMS-segment) som har specifierad statuskod och som den senast tillagda statusen.\n        <\/td>\n        \n          
\n  \"mobileOriginatedMessages\": {\n      \"201\": {\n          \"messages\": 199,\n          \"sms\": 398\n      }\n  }\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n<\/div>\n\n\n\n