On Task Assigned

​

When it runs

• Manual assignment on the Task page of the web app.
• Bulk assignment of several tasks at once.
• Routing dispatch: tasks assigned when a routing result is dispatched.
• Automation: a task assigned by another automation.
• API: assignment through the API.

​

Set it up

1. On Workflow › Automation, click New.
2. Event: On Task Assigned.
3. Task Type: the task type to watch.
4. Automation Type: one of
   • Create Task
   • Webhook
   • Notification
5. Fill in the Automation detail and click Submit.

​

Use cases

​

Webhook payload

{
  "event": "on_task_assigned",
  "timestamp": "2024-01-15T11:00:00.000Z",
  "task": {
    "id": "task_id_123",
    "flow": "Delivery",
    "flowId": "flow_id_456",
    "invoice": "INV-2024-001",
    "name": "Budi Santoso",
    "phone": "+6281234567890",
    "address": "Jl. Sudirman No. 123, Jakarta",
    "deliveryCoordinate": "-6.2088,106.8456",
    "startTime": "2024-01-15T14:00:00.000Z",
    "endTime": "2024-01-15T16:00:00.000Z",
    "status": "assigned",
    "priority": "normal"
  },
  "assignee": {
    "id": "user_id_789",
    "name": "Field Worker Name",
    "email": "[email protected]",
    "phone": "+6281234567891",
    "teamId": "team_id_101"
  },
  "assigner": { "id": "user_id_102", "name": "Operations Manager", "email": "[email protected]" },
  "hub": { "id": "hub_id_789", "name": "Jakarta Hub" },
  "assignmentTime": "2024-01-15T11:00:00.000Z"
}

​

Troubleshooting

• Check that its Active switch is on and the task type matches.
• Check that the rules don’t exclude the task.
• Assign to a user, not only to a team: the task must become assigned.

• Look for several active automations on the same task type.
• Make your endpoint answer with a 2xx status (200 or 204).

• Check the phone number in the field chosen as Receiver Phone Number.
• Look at the log for the failed run and its response.