Guia da Activity API
A Activity API permite enviar atividade personalizada de qualquer aplicativo externo para o Dailybot. Use-a para rastrear trabalho de ferramentas que não possuem uma integração nativa com o Dailybot — a atividade é exibida nos relatórios de check-in junto com dados de outras integrações.
Requisito de faturamento: Sua organização deve ter um plano de faturamento que suporte APIs e integrações para usar a Activity API.
Começar
- Acesse Configurações do Dailybot → Integrações → Activity API
- Copie sua Activity Hook URL única
- Use esta URL como destino para requisições POST do seu aplicativo
Requisição POST
Envie uma requisição POST com Content-Type: application/json para sua Activity Hook URL.
Campos da requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
custom_type | string | Sim | Identificador de atividade (máx 128 caracteres). Usado para categorizar o tipo de atividade. |
message | string | Sim | Texto com detalhes da atividade exibido no relatório. |
link | string | Não | URL que se torna clicável nos relatórios do Dailybot. |
user_email | string | Não | Email do usuário do Dailybot para atribuir a atividade. Use este ou user_uuid. |
user_uuid | string | Não | UUID do usuário do Dailybot para atribuir a atividade. Use este ou user_email. |
Identifique o usuário com user_email ou user_uuid. Pelo menos um é necessário para atribuir a atividade a um membro da equipe.
Exemplo de requisição
curl -X POST "https://your-activity-hook-url/" \
-H "Content-Type: application/json" \
-d '{
"custom_type": "deployment",
"message": "Deployed v2.1.0 to production",
"link": "https://github.com/org/repo/releases/tag/v2.1.0",
"user_email": "[email protected]"
}'Códigos de resposta
| Código | Descrição |
|---|---|
200 | Atividade registrada com sucesso |
404 | Email ou UUID do usuário não encontrado na organização |
Rastreamento de atividade nos relatórios
- Abra as configurações do check-in que deseja aprimorar
- Vá para Compartilhamento → Opções Avançadas
- Ative o Rastreamento de atividade
A atividade registrada dentro de 24 horas antes de uma resposta de check-in até o final desse dia aparece como uma coluna adicionada automaticamente nos relatórios.
Casos de uso
- Implantações — Registre eventos de implantação com detalhes de versão e ambiente
- Tickets de suporte — Rastreie tickets de suporte resolvidos por membro da equipe
- Ferramentas de design — Envie atividade do Figma, Sketch ou outras ferramentas de design
- Scripts personalizados — Integre com pipelines CI/CD, sistemas de monitoramento ou ferramentas internas
- Zapier / Make — Use a Activity Hook URL como destino de webhook em plataformas de automação
