Richiedi l’accesso anticipato

Inserisci il tuo nome e un indirizzo email o un numero di telefono. Ti contatteremo con tutte le informazioni per accedere a Tajo.

In questa pagina

Gestione delle attività

L’API Tasks del CRM di Brevo ti permette di creare e gestire attività commerciali, follow-up e promemoria per mantenere il tuo team organizzato all’interno della piattaforma Tajo.

Panoramica

La gestione delle attività è essenziale per:

  • Follow-up commerciali con promemoria automatici e scadenze
  • Coordinamento del team assegnando le attività a membri specifici
  • Avanzamento delle trattative collegando le attività a trattative e aziende
  • Tracciamento delle attività monitorando la produttività del team e i tassi di completamento
  • Coinvolgimento dei clienti pianificando contatti e verifiche sul programma fedeltà

Avvio rapido

Creare un’attività 

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"
  }
}

Risposta 

{
  "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"
}

Recuperare le attività

Elencare tutte le attività 

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

Risposta 

{
  "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
}

Filtrare le attività 

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

Recuperare una singola attività 

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

Tipi di attività

Il CRM supporta diversi tipi di attività per le varie azioni commerciali:

TipoDescrizioneCaso d’uso
callTelefonataChiamate di follow-up, demo, verifiche
emailContatto via emailProposte, aggiornamenti, newsletter
meetingIncontro di persona o virtualeDemo, negoziazioni, revisioni
todoAttività genericaLavoro interno, ricerca, preparazione
deadlineAttività con scadenzaRinnovi contrattuali, milestone

Creazione automatica delle attività

Automazione delle attività in base alle trattative

Crea attività in automatico quando le trattative avanzano di fase:

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' }
    });
  }
}

Operazioni massive sulle attività 

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;
  }
}

Riferimento dei metodi API 

// 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
});

Buone pratiche

  1. Automatizza la creazione delle attività: collega le attività ai cambi di fase delle trattative per follow-up sempre coerenti
  2. Imposta promemoria: configura sempre un promemoria per le attività con scadenze ravvicinate
  3. Collega i record: associa le attività a trattative, aziende e contatti per avere il contesto
  4. Monitora il completamento: tieni d’occhio i tassi di completamento per valutare le prestazioni del team
  5. Usa i tipi di attività: categorizza correttamente le attività per avere report accurati

Gestione degli errori 

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);
  }
}

Passi successivi

Richiedi l’accesso anticipato

Inserisci il tuo nome e un indirizzo email o un numero di telefono. Ti contatteremo con tutte le informazioni per accedere a Tajo.

rilevamento automatico
Assistente AI

Ciao! Chiedimi qualsiasi cosa sulla documentazione.