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

# Escopos da API Key

> Permissões do canal Instagram: enviar, consultar, cancelar, editar, apagar e gerenciar conexões.

<Tip>
  Cada escopo é uma **porta** na sua chave: conexão, envio, leitura, edição ou moderação de comentários, abra só o necessário.
</Tip>

Cada **escopo** libera um tipo de operação no Instagram. Use só o que sua integração precisa.

## Como enviar a chave

**Recomendado**

```http theme={null}
Authorization: Bearer sk_live_sua_chave_aqui
```

**Alternativo**

```http theme={null}
x-api-key: sk_live_sua_chave_aqui
```

<Info>
  A API Key pertence a **um** workspace. Você não acessa outro workspace com a mesma chave.
</Info>

## Combinações comuns

<CardGroup cols={2}>
  <Card title="Envio básico" icon="paper-plane">
    `instagram:instances:create`, `instagram:instances:list`, `instagram:send`
  </Card>

  <Card title="Enviar e consultar" icon="magnifying-glass">
    `instagram:send`, `instagram:read`
  </Card>

  <Card title="Com cancelamento" icon="clock">
    `instagram:send`, `instagram:cancel`
  </Card>

  <Card title="Fluxo completo" icon="list-check">
    `instagram:send`, `instagram:read`, `instagram:cancel`, `instagram:update`, `instagram:delete`
  </Card>
</CardGroup>

<Warning>
  Lista de escopos **vazia** na criação = acesso **ADMIN**. Em produção, restrinja sempre.
</Warning>

## Escopos disponíveis

<AccordionGroup>
  <Accordion title="instagram:instances:list">
    Ver conexões Instagram do workspace.
  </Accordion>

  <Accordion title="instagram:instances:create">
    Criar conexão e completar login (inclui resolver challenge).
  </Accordion>

  <Accordion title="instagram:instances:disconnect">
    Desconectar sessão ativa.
  </Accordion>

  <Accordion title="instagram:instances:delete">
    Remover uma conexão.
  </Accordion>

  <Accordion title="instagram:send">
    Enviar DMs: texto e mídia por URL HTTPS.
  </Accordion>

  <Accordion title="instagram:read">
    Listar enviados, inbound, status da conexão e comentários.
  </Accordion>

  <Accordion title="instagram:cancel">
    Cancelar mensagem na fila ou agendada.
  </Accordion>

  <Accordion title="instagram:update">
    Editar texto de mensagem já enviada (janela de 15 min, até 5 edições, máx. 1000 caracteres).
  </Accordion>

  <Accordion title="instagram:delete">
    Apagar mensagem enviada para todos (unsend), quando o Instagram permitir.
  </Accordion>

  <Accordion title="instagram:comments:reply">
    Responder comentários em mídia própria.
  </Accordion>

  <Accordion title="instagram:comments:moderate">
    Moderar comentários (ex.: apagar).
  </Accordion>
</AccordionGroup>

## Limite por conexão

Se a chave tiver **lista de instâncias** configurada, ela só enxerga essas conexões.

## Próximos passos

* [Quick Start](/instagram-api/como-funciona/quick-start)
* [Eventos dos webhooks](/instagram-api/como-funciona/eventos-do-webhooks)
* [Introdução](/instagram-api/como-funciona/introducao)