ArgorantDocs

Responder às respostas

Todas as respostas de todas as campanhas em uma caixa de entrada. Responda na mesma conversa, encaminhe e marque respostas como interessado, reunião agendada ou uma etapa do seu próprio funil.

Veja as novas respostas

Shell
curl "https://app.argorant.com/api/v1/inbox?folder=replies&limit=25" -H "Authorization: Bearer $ARGORANT_API_KEY"

folder é all, replies, interested, not_interested, out_of_office, bounces ou unsubscribes. Filtre mais com campaign_id, classification ou uma palavra de busca em q. As conversas vêm com a atividade mais recente primeiro, incluindo as suas próprias respostas. As listas mostram os primeiros 300 caracteres da mensagem mais recente. Pagine com cursor e next_cursor até has_more ser false; todas as conversas podem ser alcançadas. Uma conversa que ninguém marcou ainda tem a classificação unknown.

Leia só o que mudou

Shell
curl "https://app.argorant.com/api/v1/inbox?received_after=2026-11-10T09:00:00Z&limit=100" -H "Authorization: Bearer $ARGORANT_API_KEY"

received_after mantém as conversas cuja mensagem mais nova da pessoa chegou depois desse momento. updated_after também conta as suas próprias respostas. Cada conversa tem lead_id, updated_at e last_received_at. Se você lê a API em intervalos fixos, comece cada leitura alguns minutos antes do fim da anterior e ignore os ids que você já tem. Uma linha pode ser salva um instante depois do horário que ela registra, então uma janela que começa exatamente onde a última terminou pode perdê-la. Com webhooks, nada disso é necessário.

Leia uma conversa

Shell
curl "https://app.argorant.com/api/v1/inbox/$THREAD" -H "Authorization: Bearer $ARGORANT_API_KEY"

$THREAD é o id da lista. Você recebe o texto completo e a conversa inteira, da mais antiga para a mais nova: seus e-mails, as respostas da pessoa, as suas respostas e os encaminhamentos.

Responda na mesma conversa

Shell
curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/reply" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: reply-jane-1" \
  -H "Content-Type: application/json" \
  -d '{"body":"Thursday 10:00 works. I will send an invite."}'

A resposta sai na hora, na mesma conversa, pela caixa de e-mail que recebeu a resposta. Um agente deve mostrar o texto ao usuário e esperar um sim. O Idempotency-Key garante que uma nova tentativa nunca envie duas vezes.

Encaminhe para um colega

Shell
curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/forward" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: fwd-jane-1" \
  -H "Content-Type: application/json" \
  -d '{"to":["sales-lead@yourcompany.com"],"note":"Hot lead, please call her this week."}'

O encaminhamento leva o histórico e os anexos. Em até três minutos a conversa mostra se ele foi entregue.

Marque e acompanhe seu funil

Todo workspace tem cinco marcações padrão: positive (exibida como Interessado), meeting_request, out_of_office, unsubscribe e neutral (exibida como Outros). Você pode ativar not_interested, question, referral, wrong_person e meeting_booked. Adicione suas próprias etapas:

Shell
curl -X POST "https://app.argorant.com/api/v1/reply-statuses" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"label":"Proposal sent","color":"purple"}'

curl -X POST "https://app.argorant.com/api/v1/inbox/$THREAD/classify" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"classification":"proposal_sent"}'

interested é entendido como positive. Renomeie, mude a cor, oculte ou mostre uma etapa com PATCH /api/v1/reply-statuses/{key}. Exclua uma das suas próprias etapas com DELETE /api/v1/reply-statuses/{key}; as conversas dela voltam para neutro.

Seja avisado na hora

Um webhook para reply.received chama o seu servidor quando uma pessoa responde, um para reply.positive quando uma resposta recebe a marcação Interessado ou Pedido de reunião, e um para reply.label_changed sempre que alguém define ou muda uma marcação, então ninguém fica esperando a próxima consulta.

Pelo terminal

Shell
npx argorant inbox list --folder replies
npx argorant inbox read <thread-id>
npx argorant inbox reply <thread-id> --body "Thursday works."
npx argorant inbox classify <thread-id> meeting_booked

Nesta página