Como transformar uma conversa do WhatsApp em uma tarefa da WACRM

Na WACRM, uma tarefa sempre começa a partir de uma conversa: um cliente pergunta algo que sua equipe precisa acompanhar, e em vez de guardar isso de cabeça, você transforma a mensagem em uma tarefa ali mesmo, no Inbox. Este tutorial cobre o que essa tela realmente faz hoje, como fazer o mesmo (mais a atribuição) pela API, e onde a ponte com o sistema Work da WACRM ainda precisa de um pedido à WACRM em vez de um botão que você mesmo liga.

O que você precisa antes de começar

• Uma conta WACRM Workspace com pelo menos um projeto e pelo menos uma conversa em Conversations → Inbox.
• Só para os passos de API: curl (ou qualquer cliente HTTP que consiga definir um cabeçalho), e uma chave de API em Developer / API & MCP.

Crie uma tarefa pelo Inbox

1. Abra Conversations → Inbox e selecione a conversa que você quer acompanhar.
2. No painel lateral, encontre o cartão Tasks, abaixo do cartão Contact da conversa (e abaixo dos cartões Consent e Billing também, quando eles aparecem para esse contato). Ele começa vazio, mostrando No tasks yet, até você criar a primeira tarefa.
3. Clique em Create task. Abre uma caixa de diálogo pedindo um Title (obrigatório) e uma Due date (opcional).
4. Preencha um título e clique em Create task dentro da caixa de diálogo.

A caixa fecha e a nova tarefa aparece imediatamente no topo da lista — o cartão busca os dados de novo logo após uma criação bem-sucedida, então não há nada para atualizar manualmente. Cada linha mostra o título da tarefa, um chip de status e quando ela foi criada. Uma tarefa nova sempre começa com status open (chip na cor de aviso); done aparece em verde, cancelled em cinza neutro.

Não existe campo de nota ou descrição aqui — só título e data de vencimento são salvos, porque é só isso que esta caixa de diálogo envia hoje. Também não há um seletor de responsável nessa tela; a atribuição é só pela API, como mostrado abaixo.

Crie e liste tarefas pela API

Tudo que o cartão Tasks faz é sustentado por dois endpoints da Core API, com escopo por conversa:

POST /v1/conversations/{conversation}/tasks      work:write
GET  /v1/conversations/{conversation}/tasks       work:read

work:read/work:write podem ser selecionados ao criar uma chave — em Developer / API & MCP, clique em Create key, abra Restrict what this key can do (advanced) e marque work:read/work:write em WhatsApp CRM scopes (work:write precisa de uma Secret key). Criar chaves e restringir escopos depende do seu plano — o Workspace mostra um aviso de upgrade se o seu não incluir isso. Uma chave criada sem eles responde 403 insufficient_scope nessas chamadas — isso é esperado, não um bug; crie uma nova chave com os escopos marcados.

Crie uma tarefa, com atribuição

POST .../tasks exige um cabeçalho Idempotency-Key, a mesma convenção de POST /v1/messages: repetir a mesma requisição com a mesma chave reproduz a tarefa original em vez de criar uma segunda, o que torna seguro tentar de novo depois de um timeout.

curl -s -X POST "https://api.wacrm.ai/v1/conversations/your-conversation-uuid/tasks" \
  -H "Authorization: Bearer sk_live_your_scoped_key" \
  -H "Idempotency-Key: a-key-you-generate-once-per-task" \
  -H "Content-Type: application/json" \
  -d '{"title": "Ligar sobre o reembolso", "due_at": "2026-11-10", "assignee_ref": "staff-jane"}'

{
  "data": {
    "id": "0e2b1c9a-...-task-uuid",
    "conversation_id": "your-conversation-uuid",
    "title": "Ligar sobre o reembolso",
    "due_at": "2026-11-10T00:00:00+00:00",
    "assignee_ref": "staff-jane",
    "status": "open",
    "external_ref": null,
    "created_at": "2026-11-06T09:00:00+00:00"
  }
}

due_at e assignee_ref são opcionais. assignee_ref é um texto livre definido pelo seu próprio sistema — a WACRM não valida contra nenhuma lista de equipe, porque o Workspace ainda não tem um conceito próprio de atribuição de equipe para essa tela usar. external_ref fica null até a ponte Work entregar a tarefa para o outro lado.

Liste as tarefas de uma conversa

curl -s "https://api.wacrm.ai/v1/conversations/your-conversation-uuid/tasks" \
  -H "Authorization: Bearer sk_live_your_scoped_key"

É a mesma chamada que o próprio cartão Tasks do Inbox faz, então a resposta sempre bate com o que você veria na tela — as mais novas primeiro, com os mesmos campos da resposta de criação acima (8 campos cada).

Veja o status de uma tarefa voltar

Depois que uma tarefa chega ao lado do Work, uma mudança de status ali (alguém marca como concluída, ou cancela) deve voltar para a WACRM por uma chamada assinada, POST /v1/work/callbacks, e atualizar o status da tarefa para done ou cancelled. No Inbox, isso aparece como uma mudança de cor no chip da tarefa na próxima vez que você abrir a conversa de novo — esse cartão não faz consulta contínua nem busca dados de novo só por você olhar a mesma conversa outra vez, então uma mudança de status feita enquanto você já está olhando ela só vai aparecer quando você trocar para outra conversa e voltar.

Duas coisas precisam ser verdadeiras do lado da WACRM para essa ida e volta realmente acontecer, e nenhuma delas você consegue ativar sozinho pelo Workspace:

• A ponte Work precisa estar ativada. A WACRM ativa para todo o serviço, não por workspace, e hoje ela está desligada; uma ponte desativada ainda salva sua tarefa e enfileira a entrega dela, só que ela nunca chega ao outro lado nem ganha um external_ref até a WACRM ativar.
• O lado do Work precisa enviar o webhook de status. Hoje, o status de uma tarefa só muda por essa chamada — não existe nenhuma consulta de respaldo do lado da WACRM. Se uma tarefa que você criou parece travada em open mesmo tendo sido resolvida do outro lado, essa é a lacuna conhecida, não algo que esteja faltando no Workspace.

O que funciona hoje e o que depende da WACRM

Pronto para colocar isso em prática? Solicite acesso antecipado para ter um Workspace, ou deixe a equipe da WACRM configurar o seu projeto com o Quick Setup.