Tasks API

Opgaver er de to-dos og opfølgninger, der er knyttet til din konto — eventuelt linket til en kontakt, en aftale eller en kampagne. De bevæger sig gennem stadierne på din opgavetavle (dine kanban-kolonner) og har en type og prioritet. Denne guide dækker håndtering af dem via API’et.

Base URL — https://api.youraiconnector.com/v1
Autentificering — din API-nøgle (se Autentificering)
Fejl & paginering — se Fejl & Paginering

Alle eksempler herunder viser ?apiKey= forespørgselsformen i cURL og X-API-Key headeren i JavaScript og Python — begge virker på alle slutpunkter.

Opgaveobjektet

{
  "id": "tsk_abc123",
  "title": "Call Jane about her quote",
  "description": "She asked for pricing on the annual plan.",
  "type": "to_do",
  "priority": "high",
  "stage": "stage-1",
  "due_date": "2026-06-15T09:00:00.000Z",
  "remind_before_minutes": 15,
  "contact": "contacts/uid_whatsapp_15551234567",
  "campaign": "campaigns/abc123",
  "tags": ["sales"],
  "notes": "",
  "source": "api"
}

type — to_do, faq_update eller dine konfigurerede opgavetyper (se List task types).
priority — none, low, normal, high eller urgent.
stage — id’et for en fase på din opgavetavle (se List task stages). Hvis det udelades ved oprettelse, placeres opgaven i din første fase.
remind_before_minutes — hvor mange minutter før due_date en påmindelse skal sendes. 0 betyder på forfaldstidspunktet; udelad det eller send null for ingen påmindelse. Skal være et heltal fra 0 til 1440 (1 dag) — alt derover afvises. Påmindelsen kræver en due_date for at blive udløst, og omlægning af opgaven flytter påmindelsen med.

Opret en opgave

POST /tasks — kun title er påkrævet.

Bemærk: due_date accepterer et ISO 8601-tidsstempel, inklusive et tidspunkt på dagen. Kombiner det med remind_before_minutes for at få påmindelsen leveret i henhold til dine Opgave-notifikationsindstillinger. contact_id, deal_id og campaign_id linker opgaven til disse poster. assigned_to er et teammedlems bruger-id.

Få assigned_to rigtigt. Det skal være bruger-id’et for kontoejeren eller et aktivt teammedlem på den samme konto. Dette slutpunkt tjekker i øjeblikket ikke dette, så et id, der ikke tilhører nogen, accepteres og gemmes præcis som du sendte det — du får stadig en 201. Kopiér id’et i stedet for at skrive det manuelt: disse id’er blander l med L og bogstavet O med cifferet 0, og ét forkert tegn er nok. For at tjekke hvad du faktisk sendte, skal du åbne opgaven i dashboardet: feltet Ansvarlig på opgaveposten viser som standard det rå id, når det ikke matcher nogen, og vælgeren for ansvarlig i Rediger opgave viser Ikke tildelt.

cURL

curl -X POST "https://api.youraiconnector.com/v1/tasks?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Call Jane about her quote",
    "priority": "high",
    "due_date": "2026-06-15T09:00:00.000Z",
    "contact_id": "uid_whatsapp_15551234567",
    "tags": ["sales"]
  }'

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/tasks", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "Call Jane about her quote",
    priority: "high",
    due_date: "2026-06-15T09:00:00.000Z",
    contact_id: "uid_whatsapp_15551234567",
    tags: ["sales"],
  }),
});
const data = await res.json();
console.log(data.task_id);

Python

import requests

res = requests.post(
    "https://api.youraiconnector.com/v1/tasks",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "title": "Call Jane about her quote",
        "priority": "high",
        "due_date": "2026-06-15T09:00:00.000Z",
        "contact_id": "uid_whatsapp_15551234567",
        "tags": ["sales"],
    },
)
print(res.json()["task_id"])

Svar (201)

{ "success": true, "task_id": "tsk_abc123", "task": { "title": "Call Jane about her quote", "...": "..." } }

List opgaver

GET /tasks — returnerer opgaverne for din konto med valgfrie filtre.

Forespørgselsparametre (alle valgfrie): stage, priority, contact_id, deal_id, assigned_to, due_before, due_after (ISO-tidsstempler), status, include.

Kun åbne eller afsluttede. Tilføj status=open for kun at få de opgaver, der ikke er i en Færdig-fase (en opgave uden fase, eller en fase du sidenhen har fjernet, tæller som åben), eller status=completed for kun dem, der er i en Færdig-fase. Udelad den for at få alle opgaver. Enhver anden værdi returnerer en 400.

Navngivning af den linkede kontakt. En opgave bærer sin kontakt som en reference, så at liste en tavle og vise, hvem hver opgave handler om, betød tidligere, at man skulle hente hver kontakt separat. Tilføj include=contact, og hver opgave returneres med contact_name, contact_phone, contact_email og contact_channel udfyldt fra den linkede kontakt. Opgaver uden kontakt, eller hvis kontakt er blevet slettet, indeholder ganske enkelt ikke felterne.

cURL

curl "https://api.youraiconnector.com/v1/tasks?apiKey=YOUR_API_KEY&stage=stage-1&priority=high"

# with the linked contact resolved
curl "https://api.youraiconnector.com/v1/tasks?apiKey=YOUR_API_KEY&include=contact"

JavaScript

const res = await fetch("https://api.youraiconnector.com/v1/tasks?stage=stage-1&priority=high", {
  headers: { "X-API-Key": "YOUR_API_KEY" },
});
const { tasks } = await res.json();

Python

res = requests.get(
    "https://api.youraiconnector.com/v1/tasks",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"stage": "stage-1", "priority": "high"},
)
tasks = res.json()["tasks"]

Svar (200)

{ "success": true, "tasks": [{ "id": "tsk_abc123", "title": "Call Jane about her quote", "...": "..." }] }

Søg efter opgaver

POST /tasks/search — fuldtekstsøgning i titel og beskrivelse med de samme valgfrie filtre som ved listning. "include": "contact" i brødteksten fungerer også her og udfylder den linkede kontakts navn, telefonnummer, e-mail og kanal ved hvert match.

curl -X POST "https://api.youraiconnector.com/v1/tasks/search?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "quote", "priority": "high" }'

const res = await fetch("https://api.youraiconnector.com/v1/tasks/search", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ query: "quote", priority: "high" }),
});

res = requests.post(
    "https://api.youraiconnector.com/v1/tasks/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"query": "quote", "priority": "high"},
)

Hent en opgave

GET /tasks/{taskId}

curl "https://api.youraiconnector.com/v1/tasks/tsk_abc123?apiKey=YOUR_API_KEY"

const res = await fetch("https://api.youraiconnector.com/v1/tasks/tsk_abc123", { headers: { "X-API-Key": "YOUR_API_KEY" } });

res = requests.get("https://api.youraiconnector.com/v1/tasks/tsk_abc123", headers={"X-API-Key": "YOUR_API_KEY"})

En opgave, der ikke findes på din konto, returnerer 404.

Opdater en opgave

PUT /tasks/{taskId} — send kun de felter, du ønsker at ændre (title, description, type, priority, stage, due_date, remind_before_minutes, contact_id, deal_id, assigned_to, tags, notes).

curl -X PUT "https://api.youraiconnector.com/v1/tasks/tsk_abc123?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "priority": "urgent", "notes": "Left a voicemail." }'

await fetch("https://api.youraiconnector.com/v1/tasks/tsk_abc123", {
  method: "PUT",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ priority: "urgent", notes: "Left a voicemail." }),
});

requests.put(
    "https://api.youraiconnector.com/v1/tasks/tsk_abc123",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"priority": "urgent", "notes": "Left a voicemail."},
)

Fuldfør en opgave

POST /tasks/{taskId}/complete — flytter opgaven til din tavles fuldførte stadie. Et valgfrit notes-felt gemmer en afsluttende note.

curl -X POST "https://api.youraiconnector.com/v1/tasks/tsk_abc123/complete?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "notes": "Closed — customer signed up." }'

await fetch("https://api.youraiconnector.com/v1/tasks/tsk_abc123/complete", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ notes: "Closed — customer signed up." }),
});

requests.post(
    "https://api.youraiconnector.com/v1/tasks/tsk_abc123/complete",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"notes": "Closed — customer signed up."},
)

Flyt & omorganiser (kanban)

Flyt en opgave til et andet stadie — POST /tasks/{taskId}/move med new_stage_id (destinationsstadiet) og new_position (den nul-baserede plads inden for det stadie; påkrævet, skal være et ikke-negativt heltal):

curl -X POST "https://api.youraiconnector.com/v1/tasks/tsk_abc123/move?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "new_stage_id": "stage-2", "new_position": 0 }'

Omorganiser opgaver inden for et stadie — POST /tasks/reorder med stage_id og opgave-id’erne i deres nye rækkefølge:

curl -X POST "https://api.youraiconnector.com/v1/tasks/reorder?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "stage_id": "stage-1", "ordered_task_ids": ["tsk_3", "tsk_1", "tsk_2"] }'

await fetch("https://api.youraiconnector.com/v1/tasks/reorder", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ stage_id: "stage-1", ordered_task_ids: ["tsk_3", "tsk_1", "tsk_2"] }),
});

requests.post(
    "https://api.youraiconnector.com/v1/tasks/reorder",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"stage_id": "stage-1", "ordered_task_ids": ["tsk_3", "tsk_1", "tsk_2"]},
)

Opgaver for en kontakt

GET /tasks/contact/{contactId} — hver opgave knyttet til én kontakt.

curl "https://api.youraiconnector.com/v1/tasks/contact/uid_whatsapp_15551234567?apiKey=YOUR_API_KEY"

const res = await fetch("https://api.youraiconnector.com/v1/tasks/contact/uid_whatsapp_15551234567", { headers: { "X-API-Key": "YOUR_API_KEY" } });

res = requests.get("https://api.youraiconnector.com/v1/tasks/contact/uid_whatsapp_15551234567", headers={"X-API-Key": "YOUR_API_KEY"})

Konfiguration af opgavetavle

List opgavestadier

GET /tasks/stages — din tavles kolonner, i rækkefølge. Brug et stadie id som stage-feltet, når du opretter eller flytter opgaver.

curl "https://api.youraiconnector.com/v1/tasks/stages?apiKey=YOUR_API_KEY"

{ "success": true, "stages": [{ "id": "stage-1", "name": "To Do", "is_completed_stage": false }, { "id": "stage-done", "name": "Done", "is_completed_stage": true }] }

Opdater opgavestadier

PUT /tasks/stages — erstat din tavles stadiekonfiguration. Send hele det sorterede stages-array.

curl -X PUT "https://api.youraiconnector.com/v1/tasks/stages?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "stages": [
    { "id": "stage-1", "name": "To Do", "is_completed_stage": false },
    { "id": "stage-2", "name": "In Progress", "is_completed_stage": false },
    { "id": "stage-done", "name": "Done", "is_completed_stage": true }
  ] }'

List opgavetyper

GET /tasks/types — de opgavetyper, der er konfigureret på din konto (bruges som type-feltet).

curl "https://api.youraiconnector.com/v1/tasks/types?apiKey=YOUR_API_KEY"

Godkend et FAQ-forslag

Når AI-botten foreslår en ny FAQ, opretter den en opgave af typen faq_update. POST /tasks/{taskId}/approve-faq gør det forslag til en rigtig FAQ i vidensbasen hos den AI-agent, der rejste det, og fuldfører opgaven. Du kan overskrive spørgsmålet/svaret i brødteksten.

Tilføj "send_follow_up": true for også at få AI’en til straks at sende svaret til opgavens tilknyttede kontaktperson som en naturlig besked i den pågældende chat (det samme som tilvalget Send svaret til kontaktpersonen nu gør i appen). Svaret sendes via den AI-agent, der håndterer den kontaktperson. Kontaktpersonens bot-indstilling forbliver uændret: På en kontaktperson, hvor AI’en er sat på pause, sendes dette ene svar, og AI’en forbliver sat på pause.

curl -X POST "https://api.youraiconnector.com/v1/tasks/tsk_faq99/approve-faq?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "question": "Do you offer refunds?", "answer": "Yes, within 30 days.", "send_follow_up": true }'

{ "success": true, "faq_id": "faq_xyz", "task_id": "tsk_faq99", "follow_up_status": "published" }

follow_up_status fortæller dig, hvad der skete med beskeden: not_requested (flag ikke sat), published (sendt), queued (botten var i gang med at svare den kontakt, svaret sendes ud, så snart den er færdig), skipped_no_contact (opgaven har ingen tilknyttet kontakt), skipped_no_campaign (ingen agent eller kampagne kunne svare for den kontakt) eller skipped_error. FAQ’en oprettes i alle tilfælde.

Se FAQs API for at administrere den resulterende FAQ.

Slet en opgave

DELETE /tasks/{taskId}

curl -X DELETE "https://api.youraiconnector.com/v1/tasks/tsk_abc123?apiKey=YOUR_API_KEY"

await fetch("https://api.youraiconnector.com/v1/tasks/tsk_abc123", { method: "DELETE", headers: { "X-API-Key": "YOUR_API_KEY" } });

requests.delete("https://api.youraiconnector.com/v1/tasks/tsk_abc123", headers={"X-API-Key": "YOUR_API_KEY"})

Næste skridt

Contacts API — link opgaver til den rette kontaktperson
Webhooks API — få besked ved Task Created, Task Updated og Task Completed
API Reference — den fulde interaktive slutpunkts-explorer

Tasks API #

Opgaveobjektet #

Opret en opgave #

List opgaver #

Søg efter opgaver #

Hent en opgave #

Opdater en opgave #

Fuldfør en opgave #

Flyt & omorganiser (kanban) #

Opgaver for en kontakt #

Konfiguration af opgavetavle #

List opgavestadier #

Opdater opgavestadier #

List opgavetyper #

Godkend et FAQ-forslag #

Slet en opgave #

Næste skridt #

Tasks API

Opgaveobjektet

Opret en opgave

List opgaver

Søg efter opgaver

Hent en opgave

Opdater en opgave

Fuldfør en opgave

Flyt & omorganiser (kanban)

Opgaver for en kontakt

Konfiguration af opgavetavle

List opgavestadier

Opdater opgavestadier

List opgavetyper

Godkend et FAQ-forslag

Slet en opgave

Næste skridt