curl --request PUT \
--url https://api.wegly.com.br/integrations/external/tasks/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Reunião de kick-off atualizada",
"start_date": "2026-03-06T14:00:00.000Z",
"end_date": "2026-03-06T15:00:00.000Z",
"has_time": true,
"recurrence_scope": "only_this"
}
'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"description": "<string>",
"is_personal": true,
"priority": 0,
"start_date": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"has_time": true,
"completed_at": "2023-11-07T05:31:56Z",
"meeting_outcome": 1,
"meeting_outcome_notes": "<string>",
"ai_processed": true,
"ai_status": 123,
"ai_error_log": "<string>",
"ai_last_action": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"crm_task_type_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_task_stage_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_lead_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_deal_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_delivery_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"recurrence_series_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"recurrence_index": 123,
"recurrence_is_exception": true,
"is_recurring": true,
"recurrence": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pattern": "every_n_days",
"interval": 123,
"week_days": [
"sunday"
],
"end_type": "none",
"start_date": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"until_date": "2023-11-07T05:31:56Z",
"index": 123,
"is_exception": true
},
"responsible_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"completed_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"responsible": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"crm_task_type": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"icon": "<string>",
"is_meeting": true
},
"crm_task_stage": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"is_completion": true,
"position": 123
},
"crm_lead": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"code": "<string>"
},
"crm_deal": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"code": "<string>"
},
"crm_delivery": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"code": "<string>",
"status": 123
},
"crm_person": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"crm_organization": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"legal_name": "<string>"
},
"crm_customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"code": 123,
"type": 123,
"status": 123,
"person": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"organization": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"legal_name": "<string>"
}
},
"mentions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mentioned": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"mentioned_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"created_at": "2023-11-07T05:31:56Z"
}
],
"recordings": [
{
"recording_url": "<string>",
"transcription_url": "<string>",
"duration": 123,
"transcription_vtt_url": "<string>",
"transcription_txt_url": "<string>"
}
],
"reminders_minutes": [
123
],
"meeting_link": "<string>",
"meeting_participants": [
"jsmith@example.com"
],
"meeting_provider": "teams_integration",
"provider": "teams_integration",
"sync_warning": "<string>",
"origin": "WEGLY",
"is_actionable": true,
"ai_generated": true,
"parent_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"hierarchy_level": 123,
"is_subtask": true,
"parent_task": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"parent_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"hierarchy_level": 123
},
"subtasks": "<array>",
"tags": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>"
}
],
"calendar_lifecycle_status": "upcoming",
"meeting_mode": "online",
"meeting_location": "<string>",
"meeting_description": "<string>",
"meeting_event": {
"provider": "<string>",
"kind": "instant_link",
"mode": "online",
"location": "<string>",
"description": "<string>",
"status": "<string>",
"sync_status": "<string>",
"sync_operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sync": {
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "synced",
"attempts": 123,
"max_attempts": 123,
"next_retry_at": "2023-11-07T05:31:56Z",
"retry_after_at": "2023-11-07T05:31:56Z",
"can_retry": true,
"error": "<string>"
},
"cancelled_at": "2023-11-07T05:31:56Z",
"online_url": "<string>",
"calendar_url": "<string>",
"attendees": [
{
"email": "jsmith@example.com",
"name": "<string>",
"response_status": "needs_action",
"response_updated_at": "2023-11-07T05:31:56Z",
"is_organizer": true,
"is_self": true
}
],
"is_external_invitation": true,
"can_manage_event": true,
"can_edit_participants": true,
"provider_updated_at": "2023-11-07T05:31:56Z",
"last_synced_at": "2023-11-07T05:31:56Z"
},
"meeting_sync": {
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "synced",
"attempts": 123,
"max_attempts": 123,
"next_retry_at": "2023-11-07T05:31:56Z",
"retry_after_at": "2023-11-07T05:31:56Z",
"can_retry": true,
"error": "<string>"
},
"meeting_attendees": [
{
"email": "jsmith@example.com",
"name": "<string>",
"response_status": "needs_action",
"response_updated_at": "2023-11-07T05:31:56Z",
"is_organizer": true,
"is_self": true
}
],
"meeting_can_manage_participants": true,
"calendar_event_url": "<string>",
"meeting_response": {
"can_respond": true,
"attendee_email": "<string>",
"response_status": "<string>"
},
"meeting_can_respond": true,
"meeting_self_attendee_email": "<string>",
"meeting_self_response_status": "<string>",
"meeting_recorder_sessions": [
{}
],
"comments": [
{}
]
}{
"statusCode": 123,
"message": "<string>",
"error": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"error": "<string>"
}Atualização de tarefa
Atualiza uma tarefa existente via integração externa. Em tarefas recorrentes, recurrence_scope define se a alteração afeta apenas a ocorrência atual, futuras, abertas ou toda a série. Enviar um campo de vínculo (crm_*_id) substitui o vínculo atual. A resposta pode trazer uma tarefa com outro id: no reagendamento de reunião (meeting_outcome: 4 com nova data) e quando a regra de recorrência é criada ou alterada.
curl --request PUT \
--url https://api.wegly.com.br/integrations/external/tasks/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Reunião de kick-off atualizada",
"start_date": "2026-03-06T14:00:00.000Z",
"end_date": "2026-03-06T15:00:00.000Z",
"has_time": true,
"recurrence_scope": "only_this"
}
'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"description": "<string>",
"is_personal": true,
"priority": 0,
"start_date": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"has_time": true,
"completed_at": "2023-11-07T05:31:56Z",
"meeting_outcome": 1,
"meeting_outcome_notes": "<string>",
"ai_processed": true,
"ai_status": 123,
"ai_error_log": "<string>",
"ai_last_action": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"crm_task_type_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_task_stage_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_lead_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_deal_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_delivery_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"crm_customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"recurrence_series_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"recurrence_index": 123,
"recurrence_is_exception": true,
"is_recurring": true,
"recurrence": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pattern": "every_n_days",
"interval": 123,
"week_days": [
"sunday"
],
"end_type": "none",
"start_date": "2023-11-07T05:31:56Z",
"end_date": "2023-11-07T05:31:56Z",
"until_date": "2023-11-07T05:31:56Z",
"index": 123,
"is_exception": true
},
"responsible_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"completed_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"responsible": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"crm_task_type": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"icon": "<string>",
"is_meeting": true
},
"crm_task_stage": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>",
"is_completion": true,
"position": 123
},
"crm_lead": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"code": "<string>"
},
"crm_deal": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"code": "<string>"
},
"crm_delivery": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"code": "<string>",
"status": 123
},
"crm_person": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"crm_organization": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"legal_name": "<string>"
},
"crm_customer": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"code": 123,
"type": 123,
"status": 123,
"person": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"organization": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"legal_name": "<string>"
}
},
"mentions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mentioned": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"mentioned_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"avatar": "<string>"
},
"created_at": "2023-11-07T05:31:56Z"
}
],
"recordings": [
{
"recording_url": "<string>",
"transcription_url": "<string>",
"duration": 123,
"transcription_vtt_url": "<string>",
"transcription_txt_url": "<string>"
}
],
"reminders_minutes": [
123
],
"meeting_link": "<string>",
"meeting_participants": [
"jsmith@example.com"
],
"meeting_provider": "teams_integration",
"provider": "teams_integration",
"sync_warning": "<string>",
"origin": "WEGLY",
"is_actionable": true,
"ai_generated": true,
"parent_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"hierarchy_level": 123,
"is_subtask": true,
"parent_task": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"parent_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"hierarchy_level": 123
},
"subtasks": "<array>",
"tags": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"color": "<string>"
}
],
"calendar_lifecycle_status": "upcoming",
"meeting_mode": "online",
"meeting_location": "<string>",
"meeting_description": "<string>",
"meeting_event": {
"provider": "<string>",
"kind": "instant_link",
"mode": "online",
"location": "<string>",
"description": "<string>",
"status": "<string>",
"sync_status": "<string>",
"sync_operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sync": {
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "synced",
"attempts": 123,
"max_attempts": 123,
"next_retry_at": "2023-11-07T05:31:56Z",
"retry_after_at": "2023-11-07T05:31:56Z",
"can_retry": true,
"error": "<string>"
},
"cancelled_at": "2023-11-07T05:31:56Z",
"online_url": "<string>",
"calendar_url": "<string>",
"attendees": [
{
"email": "jsmith@example.com",
"name": "<string>",
"response_status": "needs_action",
"response_updated_at": "2023-11-07T05:31:56Z",
"is_organizer": true,
"is_self": true
}
],
"is_external_invitation": true,
"can_manage_event": true,
"can_edit_participants": true,
"provider_updated_at": "2023-11-07T05:31:56Z",
"last_synced_at": "2023-11-07T05:31:56Z"
},
"meeting_sync": {
"operation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "synced",
"attempts": 123,
"max_attempts": 123,
"next_retry_at": "2023-11-07T05:31:56Z",
"retry_after_at": "2023-11-07T05:31:56Z",
"can_retry": true,
"error": "<string>"
},
"meeting_attendees": [
{
"email": "jsmith@example.com",
"name": "<string>",
"response_status": "needs_action",
"response_updated_at": "2023-11-07T05:31:56Z",
"is_organizer": true,
"is_self": true
}
],
"meeting_can_manage_participants": true,
"calendar_event_url": "<string>",
"meeting_response": {
"can_respond": true,
"attendee_email": "<string>",
"response_status": "<string>"
},
"meeting_can_respond": true,
"meeting_self_attendee_email": "<string>",
"meeting_self_response_status": "<string>",
"meeting_recorder_sessions": [
{}
],
"comments": [
{}
]
}{
"statusCode": 123,
"message": "<string>",
"error": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"error": "<string>"
}Authorizations
Chave de integração com prefixo wegly_, enviada em Authorization: Bearer . Não é JWT. A chave deve estar ativa, não excluída e dentro da validade. Com allowed_domain, Origin (ou Referer na ausência de Origin) precisa informar o hostname permitido. A empresa e as permissões são obtidas pela chave.
Path Parameters
UUID da tarefa.
Body
Payload parcial de atualização. Todos os campos são opcionais; recurrence_scope controla o alcance em tarefas recorrentes e is_completed conclui a tarefa. expected_updated_at permite detectar conflitos concorrentes e é opcional na API externa.
Vincula a tarefa a um lead. Substitui o vínculo atual; envie apenas um campo de vínculo.
Vincula a tarefa a uma oportunidade. Substitui o vínculo atual; envie apenas um campo de vínculo.
Vincula a tarefa a uma entrega. Substitui o vínculo atual; envie apenas um campo de vínculo.
Vincula a tarefa a uma pessoa. Substitui o vínculo atual; envie apenas um campo de vínculo.
Vincula a tarefa a uma organização. Substitui o vínculo atual; envie apenas um campo de vínculo.
Vincula a tarefa a um cliente. Substitui o vínculo atual; envie apenas um campo de vínculo.
Prioridade da tarefa: 0 baixa, 1 normal, 2 alta, 3 urgente.
0, 1, 2, 3 1 - 100Texto simples ou HTML. O HTML é higienizado: são mantidos formatação básica, listas, tabelas e links; scripts, imagens e conteúdo incorporado são removidos.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Resultado da reunião: 1 = realizada, 2 = não compareceu, 3 = cancelada, 4 = reagendada. Aceito apenas em tarefas cujo tipo é reunião. No PUT, informar um resultado conclui a tarefa; com 4 e nova data, a API cria e retorna a tarefa reagendada.
1, 2, 3, 4 Provedor de reunião online usado pela tarefa.
teams_integration, google_calendar_integration E-mails são normalizados com trim e letras minúsculas.
100320x >= 1Escopo aplicado em edições ou remoções de tarefas recorrentes. Padrão only_this.
only_this, this_and_future, open_only, all Aceito por compatibilidade e ignorado: a conclusão usa sempre o horário do servidor.
true conclui a tarefa. false não reabre: para reabrir, envie em crm_task_stage_id uma etapa que não seja de conclusão.
Tarefa pai. Subtarefas não podem ter recorrência própria.
IDs das tags da tarefa.
online, in_person Obrigatório para meeting_mode=in_person. Local não permitido para modo online.
1 - 500Descrição HTML com formatação básica; máximo de 5.000 caracteres de texto normalizado.
20000Opcional na API externa. Envie updated_at da versão consultada. Uma versão desatualizada retorna 409.
Response
Tarefa atualizada com sucesso. No reagendamento de reunião e na criação ou alteração de recorrência, o corpo traz a nova tarefa, com id diferente do informado no caminho.
Prioridade da tarefa: 0 baixa, 1 normal, 2 alta, 3 urgente.
0, 1, 2, 3 Resultado da reunião: 1 = realizada, 2 = não compareceu, 3 = cancelada, 4 = reagendada.
1, 2, 3, 4 Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Provedor de reunião online usado pela tarefa.
teams_integration, google_calendar_integration Provedor de reunião online usado pela tarefa.
teams_integration, google_calendar_integration WEGLY, GOOGLE_CALENDAR_IMPORT, MICROSOFT_TEAMS_IMPORT Show child attributes
Show child attributes
Presente na listagem hierarchy_mode=grouped.
Show child attributes
Show child attributes
Estado temporal de evento importado; null para tarefas nativas.
upcoming, in_progress, ended, cancelled, unknown online, in_person Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Elegibilidade do ator para responder ao convite, retornada na consulta por ID.
Show child attributes
Show child attributes
Sessões de gravação e seus artefatos disponíveis.
Comentários incluídos na consulta de detalhes e nos retornos de escrita.
