Be om tidlig tilgang

Skriv inn fornavnet ditt og en e-postadresse eller et telefonnummer. Vi kontakter deg med informasjon om tilgang til Tajo.

På denne siden

Oppgavehåndtering

Med Tasks API i Brevo CRM kan du opprette og administrere salgsaktiviteter, oppfølging og påminnelser som holder teamet ditt organisert i Tajo-plattformen.

Oversikt

Oppgavehåndtering er viktig for:

  • Salgsoppfølging med automatiske påminnelser og frister
  • Koordinering i teamet, der aktiviteter tildeles bestemte personer
  • Fremdrift i avtaler, der oppgaver kobles til avtaler og bedrifter
  • Aktivitetssporing, som følger produktivitet og fullføringsgrad i teamet
  • Kundeengasjement, der du planlegger kontakt og oppfølging i lojalitetsprogrammet

Kom i gang

Opprett oppgave 

POST https://api.brevo.com/v3/crm/tasks
Content-Type: application/json
api-key: YOUR_API_KEY


{
  "name": "Follow up on Enterprise Loyalty proposal",
  "taskType": "call",
  "date": "2026-02-15T10:00:00Z",
  "duration": 1800,
  "notes": "Discuss volume discount tier and loyalty point allocation",
  "assignTo": "[email protected]",
  "companiesIds": ["comp_123456789"],
  "dealsIds": ["deal_abc123def456"],
  "contactsIds": [12345],
  "done": false,
  "reminder": {
    "value": 15,
    "unit": "minutes"
  }
}

Svar 

{
  "id": "task_xyz789",
  "name": "Follow up on Enterprise Loyalty proposal",
  "taskType": "call",
  "date": "2026-02-15T10:00:00Z",
  "done": false,
  "created_at": "2026-01-25T14:30:00Z"
}

Hent oppgaver

List opp alle oppgaver 

GET https://api.brevo.com/v3/crm/tasks?limit=50&offset=0&sort=desc
Content-Type: application/json
api-key: YOUR_API_KEY

Svar 

{
  "items": [
    {
      "id": "task_xyz789",
      "name": "Follow up on Enterprise Loyalty proposal",
      "taskType": "call",
      "date": "2026-02-15T10:00:00Z",
      "duration": 1800,
      "assignTo": "[email protected]",
      "done": false,
      "companiesIds": ["comp_123456789"],
      "dealsIds": ["deal_abc123def456"],
      "created_at": "2026-01-25T14:30:00Z"
    }
  ],
  "total": 1
}

Filtrer oppgaver 

GET https://api.brevo.com/v3/crm/tasks?filters[done]=false&filters[taskType]=call&sort=date:asc

Hent én enkelt oppgave 

GET https://api.brevo.com/v3/crm/tasks/{task_id}
Content-Type: application/json
api-key: YOUR_API_KEY

Oppgavetyper

CRM-en støtter flere oppgavetyper for ulike salgsaktiviteter:

TypeBeskrivelseBruksområde
callTelefonsamtaleOppfølgingssamtaler, demoer, statussjekker
emailKontakt på e-postTilbud, oppdateringer, nyhetsbrev
meetingFysisk eller digitalt møteDemoer, forhandlinger, gjennomganger
todoGenerell oppgaveInternt arbeid, research, forberedelser
deadlineOppgave med tidsfristKontraktsfornyelser, milepæler

Automatisk oppretting av oppgaver

Oppgaveautomatisering basert på avtaler

Opprett oppgaver automatisk når avtaler flytter seg mellom stegene:

class TaskAutomation {
  constructor() {
    this.tasksApi = new TasksApi();
  }


  async createDealFollowUp(deal, stageChange) {
    const taskTemplates = {
      'Lead': {
        name: `Qualify lead: ${deal.name}`,
        taskType: 'call',
        daysFromNow: 1,
        duration: 900
      },
      'Qualified': {
        name: `Schedule demo: ${deal.name}`,
        taskType: 'meeting',
        daysFromNow: 3,
        duration: 3600
      },
      'Demo': {
        name: `Send proposal: ${deal.name}`,
        taskType: 'email',
        daysFromNow: 1,
        duration: 1800
      },
      'Proposal': {
        name: `Follow up on proposal: ${deal.name}`,
        taskType: 'call',
        daysFromNow: 5,
        duration: 900
      },
      'Negotiation': {
        name: `Finalize contract: ${deal.name}`,
        taskType: 'deadline',
        daysFromNow: 7,
        duration: 3600
      },
      'Closed Won': {
        name: `Onboard customer: ${deal.name}`,
        taskType: 'meeting',
        daysFromNow: 2,
        duration: 3600
      }
    };


    const template = taskTemplates[stageChange.newStage];
    if (!template) return null;


    const taskDate = new Date();
    taskDate.setDate(taskDate.getDate() + template.daysFromNow);


    return await this.tasksApi.createTask({
      name: template.name,
      taskType: template.taskType,
      date: taskDate.toISOString(),
      duration: template.duration,
      assignTo: deal.attributes.deal_owner,
      dealsIds: [deal.id],
      companiesIds: deal.attributes.company_id ? [deal.attributes.company_id] : [],
      contactsIds: deal.attributes.contact_id ? [deal.attributes.contact_id] : [],
      done: false,
      reminder: { value: 30, unit: 'minutes' }
    });
  }


  async createLoyaltyCheckIn(company) {
    return await this.tasksApi.createTask({
      name: `Loyalty program check-in: ${company.name}`,
      taskType: 'call',
      date: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString(),
      duration: 1800,
      assignTo: company.attributes.account_manager,
      companiesIds: [company.id],
      notes: `Review tier status: ${company.attributes.loyalty_tier}\nAnnual spend: $${company.attributes.annual_spend}`,
      done: false,
      reminder: { value: 1, unit: 'days' }
    });
  }
}

Oppgaveoperasjoner i bulk 

class BulkTaskManager {
  async createRenewalTasks(daysBeforeExpiry = 90) {
    const renewalDate = new Date();
    renewalDate.setDate(renewalDate.getDate() + daysBeforeExpiry);


    const companies = await this.companiesApi.getCompanies({
      filters: {
        'attributes.renewal_date': `<${renewalDate.toISOString()}`
      }
    });


    const tasks = [];
    for (const company of companies.items) {
      const task = await this.tasksApi.createTask({
        name: `Contract renewal: ${company.name}`,
        taskType: 'deadline',
        date: company.attributes.renewal_date,
        assignTo: company.attributes.account_manager,
        companiesIds: [company.id],
        notes: `Contract value: $${company.attributes.contract_value}\nCurrent tier: ${company.attributes.loyalty_tier}`,
        done: false,
        reminder: { value: 7, unit: 'days' }
      });
      tasks.push(task);
    }


    return tasks;
  }
}

Oversikt over API-metoder 

// Create a new task
const task = await tasksApi.createTask({
  name: 'Follow up call',
  taskType: 'call',
  date: '2026-02-15T10:00:00Z',
  assignTo: '[email protected]',
  done: false
});


// Get task by ID
const task = await tasksApi.getTask('task_xyz789');


// Update task
await tasksApi.updateTask('task_xyz789', {
  done: true,
  notes: 'Customer agreed to upgrade tier'
});


// Delete task
await tasksApi.deleteTask('task_xyz789');


// List tasks with filtering
const tasks = await tasksApi.getTasks({
  filters: {
    done: false,
    taskType: 'call',
    assignTo: '[email protected]'
  },
  sort: 'date:asc',
  limit: 50
});

Beste praksis

  1. Automatiser oppretting av oppgaver: Koble oppgaver til endringer i avtalesteg, så blir oppfølgingen konsekvent
  2. Sett påminnelser: Konfigurer alltid påminnelser for oppgaver med tidsfrist
  3. Koble oppføringer: Knytt oppgaver til avtaler, bedrifter og kontakter, så får du konteksten med
  4. Følg fullføring: Følg med på fullføringsgraden for å se hvordan teamet presterer
  5. Bruk oppgavetyper: Kategoriser oppgavene riktig, så blir aktivitetsrapportene presise

Feilhåndtering 

try {
  const task = await tasksApi.createTask(taskData);
  console.log('Task created:', task.id);
} catch (error) {
  if (error.status === 400) {
    console.error('Invalid task data:', error.message);
  } else if (error.status === 404) {
    console.error('Associated deal or contact not found');
  } else {
    console.error('Unexpected error:', error);
  }
}

Neste steg

Be om tidlig tilgang

Skriv inn fornavnet ditt og en e-postadresse eller et telefonnummer. Vi kontakter deg med informasjon om tilgang til Tajo.

automatisk gjenkjenning
AI-assistent

Hei! Spør meg om dokumentasjonen.