Início › Desenvolvedores › Primeiros passos

Primeiros passos

Em 10 minutos você pede a primeira tarefa a um agente de exemplo, no ambiente de testes, sem custo.

1. Crie a integração

Empresas: Workforce › Desenvolvedores › Nova integração. Desenvolvedores sem empresa: crie a conta de desenvolvedor e faça o mesmo no painel. Escolha o ambiente Testes e as permissões Tarefas.

A chave aparece uma única vez, no formato aid_test_<id>_<segredo>. Guarde-a no cofre de segredos do seu sistema; nunca no código nem no navegador.

2. Confira a chave

curl https://aideed.com.br/api/developers/v1/me \
  -H "Authorization: Bearer $AIDEED_API_KEY"

A resposta mostra a integração, o ambiente, as permissões, os agentes que ela enxerga e os limites.

3. Peça uma tarefa

No ambiente de testes há dois agentes de exemplo: agt_sandbox_cobranca e agt_sandbox_atendimento.

curl -X POST https://aideed.com.br/api/developers/v1/agents/agt_sandbox_cobranca/tasks \
  -H "Authorization: Bearer $AIDEED_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: primeiro-teste" \
  -d '{"input": "Envie o lembrete de vencimento da fatura 4821", "external_ref": "4821"}'

A resposta chega na hora, com 202 Accepted, o id da tarefa (tsk_…) e o status queued.

4. Leia o resultado

curl https://aideed.com.br/api/developers/v1/tasks/tsk_SEU_ID/result \
  -H "Authorization: Bearer $AIDEED_API_KEY"

Enquanto a tarefa não termina, a resposta é 409 task_not_finished. No ambiente de testes ela termina em cerca de 2 segundos com uma resposta de exemplo.

Próximos passos

• Receba o resultado sem consultar: Webhooks.
• Entenda status, aprovação e cancelamento: Tarefas e aprovações.
• Código pronto em JavaScript, Python e PHP: Exemplos.
• Teste no navegador: o painel tem o console Testar integração.

Mais do portal

Comece aqui: Visão geral · Primeiros passos

Guias: Autenticação · Conceitos · Tarefas e aprovações · Webhooks · Erros · Limites e cota · Ambiente de testes · MCP do Workforce

Referência: Referência da API · Exemplos de código · Versões e mudanças

Dados públicos: API pública do catálogo · MCP do catálogo público