Criar instância Instagram

curl --request POST \ --url https://api.notifique.dev/v1/instagram/instances \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "Instagram atendimento", "acceptInstagramTerms": true, "auth": { "mode": "password", "username": "seu_usuario", "password": "sua_senha" }, "expectedUsername": "seu_usuario" } '

{ "success": true, "data": { "id": "inst_abc", "name": "Instagram atendimento", "status": "ACTIVE", "mode": "UNOFFICIAL", "username": "seu_usuario", "igUserPk": "17841" } }

Autorizações

Authorization

string

header

obrigatório

Authorization: Bearer sk_live_...

Corpo

application/json

name

string

obrigatório

Minimum string length: 2

Exemplo:

"Instagram atendimento"

acceptInstagramTerms

enum<boolean>

Obrigatório no modo UNOFFICIAL. Confirma ciência do risco de restrição pela plataforma.

Opções disponíveis:

true

mode

enum<string>

padrão:UNOFFICIAL

Tipo de conexão. UNOFFICIAL (padrão): login Instagram. OFFICIAL: linha Meta. OFFICIAL_BYOK: token e IDs Meta próprios.

Opções disponíveis:

UNOFFICIAL,

OFFICIAL,

OFFICIAL_BYOK

generateShareableLink

boolean

padrão:false

Gera um link para outra pessoa concluir a conexão Meta. Omita quando você envia credenciais na hora.

metaAccessToken

string

Page Access Token (OFFICIAL_BYOK).

facebookPageId

string

Facebook Page ID vinculada à conta IG (OFFICIAL_BYOK).

igBusinessAccountId

string

Instagram Business Account ID (OFFICIAL_BYOK).

metaAppSecret

string

App Secret Meta para validar webhooks (OFFICIAL_BYOK).

metaEmbeddedCode

string

Código do Facebook Login (OFFICIAL). Alternativa: generateShareableLink=true.

expectedUsername

string

Opcional. Username esperado no login (conexão não oficial). Se o login conectar outra conta, a API responde 409 (INSTAGRAM_ACCOUNT_MISMATCH).

Exemplo:

"seu_usuario"

termsVersion

string

Exemplo:

"v1"

locale

string

Exemplo:

"pt-BR"

timezone

string

Exemplo:

"America/Sao_Paulo"

auth

object

Show child attributes

Resposta

Instância criada (ACTIVE ou PENDING com shareableLink).

success

boolean

Exemplo:

true

data

object

Show child attributes