Används för att inleda en ny dialog med en kund genom att skicka det första meddelandet.
Starta en ny konversation #
Quick start #
Quick start (cURL)
Kopiera till urklipp
curl -X POST https://api.ip1.net/v3/conversations \
-H "Authorization: Bearer API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"brand": "min-butik-ab",
"agent": "kundservice",
"recipient": "46700123456",
"content": "Hej! Hur kan vi hjälpa dig idag?"
}'Anrop #
Endpoint: /conversations
Metod: POST
Exempel på anropsdata #
filename.js
Kopiera till urklipp
{
"brand": "min-butik-ab",
"agent": "kundservice",
"recipient": "46700123456",
"content": "Hej! Hur kan vi hjälpa dig idag?",
"uniqueId": "first-contact-99"
}Fält för anropsdata #
| Fältnamn | Beskrivning | Required | Typ | Exempel |
| brand | Namnet på ditt brand | Ja | String | "Min-Butik-AB" |
| agent | Namnet på din agent | Ja | String | ”Kundservice” |
| recipient | Mottagarens nummer | Ja | Object | ”46700123456”: { ”name”: ”Kalle” } |
| content | Själva meddelandets innehåll | Ja (Bortsett när man använder Cards) | String | ”Hej {name}! Din order är nu skickad.” |
| type | Meddelandet i konversationens typ | Ja | String | ”Carousell” |
| uniqueId | Unikt ID för att undvika dubbletter. | Nej | String | ”conversation-12345-id” |
Respons #
Returnerar första meddelandet i den skapade konversationen.
Exempel på responsdata #
Responsdata (JSON)
Kopiera till urklipp
{
"id": "65eb3d14f1234567890abcdef",
"conversationId": "65e15d14f1234547890ghijkl",
"brand": "min-butik-ab",
"agent": "kundservice"
"recipient": "46700123456",
"content": "Hej! Hur kan vi hjälpa dig idag?",
"type": "Carousell"
"modified": "2026-03-09T08:00:05Z",
"uniqueId": "conversation-12345-id"
}Fält för responsdata #
| Fältnamn | Beskrivning | Typ | Exempel |
| id | Meddelande ID som den aktuella konversationen hör till | String | "65eb3d14f1234567890abcdef" |
| brand | Varumärkets interna namn. | String | ”min-butik-ab” |
| agent | Agenten som hanterar konversationen. | String | ”kundservice” |
| conversationId | Den aktuella konversationens ID | String | ”65e15d14f1234547890ghijkl” |
| recipient | Mottagarens nummer | Object | ”46700123456”: { ”name”: ”Kalle” } |
| content | Det första meddelandet i konversationens innehåll | String | ”Hej! Hur kan vi hjälpa dig idag?” |
| type | Det första meddelandet i konversationens typ | String | ”Carousell” |
| modified | Datumstämpel för senaste ändringen (Statusuppdatering, svar etc.) | DateTime | ”2026-03-09T08:00:05Z” |
| uniqueId | Unikt ID för att undvika dubbletter. | String | ”conversation-12345-id” |
Fortsätt konversation #
Används för att skicka ytterligare meddelanden i en redan pågående konversation.
Quick start #
Quick start (cURL)
Kopiera till urklipp
curl -X POST https://api.ip1.net/v3/conversations/65e15d14f1234547890ghijkl \
-H "Authorization: Bearer API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content": "Här kommer informationen du bad om."}'Anrop #
Endpoint: /conversations/{conversation}
Metod: GET
Exempel på anropsdata #
Anrop (URL)
Kopiera till urklipp
https://api.ip1.net/v3/conversations/65e15d14f1234547890ghijklFält för anrop #
| Fältnamn | Beskrivning | Required | Typ | Exempel |
| id | ID för konversationen du vill fortsätta. | Ja | Query Param | 65e15d14f1234547890ghijkl |
Respons #
Returnerar detaljer om det nya meddelandet i konversationen.
Exempel på responsdata #
Responsdata (JSON)
Kopiera till urklipp
{
"id": "65eb3d14f1234567890abcdef",
"conversationId": "65e15d14f1234547890ghijkl",
"brand": "min-butik-ab",
"agent": "kundservice"
"recipient": "46700123456",
"content": "Hej! Hur kan vi hjälpa dig idag?",
"type": "Carousell"
"modified": "2026-03-09T08:00:05Z",
"uniqueId": "conversation-12345-id"
}Exempel på responsdata #
| Fältnamn | Beskrivning | Typ | Exempel |
| id | Det nya meddelandets ID | String | "65eb3d14f1234567890abcdef" |
| brand | Varumärkets interna namn. | String | ”min-butik-ab” |
| agent | Agenten som hanterar konversationen. | String | ”kundservice” |
| conversationId | Den aktuella konversationens ID | String | ”65e15d14f1234547890ghijkl” |
| recipient | Mottagarens nummer | Object | ”46700123456”: { ”name”: ”Kalle” } |
| content | Det nya meddelandets innehåll | String | ”Hej! Hur kan vi hjälpa dig idag?” |
| type | Det nya meddelandets Typ | String | ”Carousell” |
| modified | Datumstämpel för senaste ändringen | DateTime | ”2026-03-09T08:00:05Z” |
| uniqueId | Unikt ID för att undvika dubbletter. | String | ”conversation-12345-id” |