> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aciona.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Receba seu primeiro acionamento em 10 minutos

> Do zero ao primeiro acionamento reconhecido: organização, time, serviço, escala, fonte de alerta e alerta de teste.

Este guia percorre o caminho completo do produto uma vez só. No final você terá recebido um alerta real, visto um acionamento ser criado, sido notificado e reconhecido o acionamento.

<Info>
  **Tempo estimado:** 10 minutos. **Você vai precisar de:** uma conta no aciona.me e um terminal com `curl`. Nenhuma ferramenta de monitoramento é necessária para este teste.
</Info>

<Steps>
  <Step title="Crie sua organização" icon="building">
    Ao criar sua conta, o aciona.me pede o nome da organização. Ela é o espaço isolado da sua empresa — todos os dados criados a partir daqui pertencem a ela.

    Se você já foi convidado para uma organização existente, pule esta etapa.

    [Detalhes](/pt-br/comece-agora/criar-organizacao)
  </Step>

  <Step title="Garanta que você é membro ativo" icon="user">
    Para este primeiro teste, você mesmo será o plantonista. Como criador da organização, você já é **owner** e tem todas as permissões.

    Convidar o restante do time pode ficar para depois.

    [Detalhes](/pt-br/comece-agora/convidar-membros)
  </Step>

  <Step title="Crie um time" icon="users">
    Em **Times**, crie um time — por exemplo `Plataforma` — e adicione você mesmo como membro.

    O time é a unidade de responsabilidade: é ele que liga serviços a escalas de plantão.

    [Detalhes](/pt-br/comece-agora/criar-time)
  </Step>

  <Step title="Crie um serviço" icon="server">
    Em **Serviços**, crie um serviço — por exemplo `api-pagamentos` — e defina o time recém-criado como responsável.

    Anote o nome exato: você vai usá-lo no alerta de teste para que o roteamento encontre esse serviço.

    [Detalhes](/pt-br/comece-agora/criar-servico)
  </Step>

  <Step title="Configure uma escala de plantão" icon="calendar-clock">
    Em **Escalas**, crie uma escala para o time, com você como único participante.

    Para o teste, use rotação **24x7** e o fuso horário da sua equipe (por exemplo `America/Sao_Paulo`). Assim você está de plantão agora, independentemente do horário.

    <Warning>
      Sem escala ativa com participante válido, o acionamento é criado mas fica sem responsável — e cai no aviso para os owners da organização.
    </Warning>

    [Detalhes](/pt-br/comece-agora/criar-escala)
  </Step>

  <Step title="Crie uma fonte de alerta" icon="webhook">
    Em **Fontes de alerta**, crie uma fonte do tipo **Genérico** com o nome `Teste`.

    Ao salvar, o aciona.me mostra a **URL do webhook** e o **token**.

    <Warning>
      O token é exibido **uma única vez**. Copie e guarde agora; depois só é possível rotacioná-lo.
    </Warning>

    [Detalhes](/pt-br/comece-agora/criar-fonte-de-alerta)
  </Step>

  <Step title="Envie um alerta de teste" icon="terminal">
    Substitua `<idDaFonte>` e `<tokenDaFonte>` pelos valores que você acabou de copiar, e ajuste `service` para o nome exato do seu serviço:

    ```bash Alerta de teste theme={null}
    curl -X POST "https://ingress.aciona.me/webhooks/<idDaFonte>" \
      -H "Content-Type: application/json" \
      -H "X-Aciona-Token: <tokenDaFonte>" \
      -d '{
        "externalId": "teste-001",
        "title": "Latência acima do limite na API de pagamentos",
        "description": "p95 acima de 2s por 5 minutos",
        "severity": "critical",
        "service": "api-pagamentos",
        "status": "firing",
        "labels": { "env": "prod", "team": "plataforma" },
        "url": "https://exemplo.com/dashboard"
      }'
    ```

    A resposta esperada é `202 Accepted`. Qualquer outro código indica um problema de configuração — veja [Erro no webhook](/pt-br/solucao-de-problemas/erro-no-webhook).
  </Step>

  <Step title="Confirme o acionamento" icon="siren">
    Abra **Acionamentos** no painel. Em poucos segundos deve aparecer um acionamento `critical` com o título enviado, associado ao serviço, ao time e a você como plantonista.

    Abra o acionamento e veja a linha do tempo: alerta recebido, acionamento criado, responsável notificado.
  </Step>

  <Step title="Reconheça o acionamento" icon="circle-check">
    Clique em **Reconhecer** (ACK). Isso registra que alguém está olhando, muda o status para `acknowledged` e **interrompe o escalonamento automático**.

    Em seguida, resolva o acionamento para fechar o ciclo.
  </Step>
</Steps>

## Pronto. E agora?

<Columns cols={2}>
  <Card title="Conecte sua ferramenta de verdade" icon="plug" href="/pt-br/fontes-de-alerta/visao-geral" horizontal>
    Grafana, Prometheus, Datadog, CloudWatch, Zabbix ou New Relic.
  </Card>

  <Card title="Convide seu time" icon="user-plus" href="/pt-br/organizacoes/membros" horizontal>
    Papéis, convites e permissões.
  </Card>

  <Card title="Monte a escala real" icon="calendar-clock" href="/pt-br/plantao/escalas" horizontal>
    Rotação semanal, fusos e substituições.
  </Card>

  <Card title="Configure notificações" icon="bell" href="/pt-br/notificacoes/visao-geral" horizontal>
    Push no celular, Slack e Microsoft Teams.
  </Card>
</Columns>

## Checklist

* [ ] Organização criada
* [ ] Time criado com pelo menos um membro
* [ ] Serviço criado e vinculado ao time
* [ ] Escala ativa com participante
* [ ] Fonte de alerta criada e token guardado
* [ ] Alerta de teste respondeu `202`
* [ ] Acionamento apareceu no painel
* [ ] Acionamento reconhecido