Gerar link de conexão
curl --request POST \
--url https://cloud.datafyapi.com.br/channels/instagram/{id}/connect-link \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/channels/instagram/{id}/connect-link', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/channels/instagram/{id}/connect-link"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"url": "https://app.datafyapi.com.br/ci/cig_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
"token": "cig_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
"expires_in": 86400
}{
"statusCode": 401,
"message": "Token de conta ausente ou inválido"
}{
"statusCode": 403,
"message": "Sua assinatura precisa estar ativa para usar a API. Acesse o painel para ativá-la."
}{
"statusCode": 404,
"message": "Canal não encontrado"
}{
"statusCode": 409,
"message": "O canal não está assinado (teste encerrado ou assinatura cancelada). Assine o canal para poder conectar."
}Conexão
Gerar link de conexão
Gera o link que o cliente abre para conectar a conta do Instagram ao canal.
POST
/
channels
/
instagram
/
{id}
/
connect-link
Gerar link de conexão
curl --request POST \
--url https://cloud.datafyapi.com.br/channels/instagram/{id}/connect-link \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/channels/instagram/{id}/connect-link', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/channels/instagram/{id}/connect-link"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"url": "https://app.datafyapi.com.br/ci/cig_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
"token": "cig_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
"expires_in": 86400
}{
"statusCode": 401,
"message": "Token de conta ausente ou inválido"
}{
"statusCode": 403,
"message": "Sua assinatura precisa estar ativa para usar a API. Acesse o painel para ativá-la."
}{
"statusCode": 404,
"message": "Canal não encontrado"
}{
"statusCode": 409,
"message": "O canal não está assinado (teste encerrado ou assinatura cancelada). Assine o canal para poder conectar."
}Um canal criado pela API nasce sem conta conectada. Esta chamada gera o link que o cliente abre para conectar a conta do Instagram dele ao canal, pelo Business Login da Meta.
Depois do sucesso, a janela se fecha sozinha. Em caso de erro ela permanece aberta, para o cliente tentar de novo.
Como usar o link
Gere o link no seu servidor e abra aurl no navegador do cliente, em uma janela nova:
const janela = window.open(url, 'datafy-instagram', 'width=600,height=760')
A janela de conexão pode levar a sua marca. No painel da Datafy, na aba Parceiros, é possível definir o logotipo, o nome da empresa e a cor do fundo. A marca é a mesma usada na conexão de WhatsApp.
Gere o link a partir do seu servidor. O token de conta dá acesso a todos os canais e não deve ser exposto no navegador.
Resultado da conexão
Ao terminar, a janela envia uma mensagem para a página que a abriu, já com os dados da conta conectada:window.addEventListener('message', (evento) => {
if (evento.origin !== 'https://app.datafyapi.com.br') return
if (evento.data?.source !== 'datafy') return
if (evento.data.event === 'connected') {
const { ig_user_id, username } = evento.data.data
// canal conectado
}
if (evento.data.event === 'error') {
// evento.data.message traz o motivo
}
})
| Evento | Conteúdo |
|---|---|
connected | data com ig_user_id e username |
error | message com o motivo da falha |
Os dados da mensagem já bastam para registrar a conexão. Use Consultar canal quando precisar dos demais campos, como a foto e o nome do perfil, ou para confirmar a conexão mais tarde.
Validade
O link vale 24 horas e é de uso único: ele deixa de funcionar assim que a conexão é concluída. Para conectar de novo, gere um link novo.A conta precisa ser profissional (Empresa ou Criador de conteúdo). Contas pessoais não aparecem no Business Login.
Resposta
| Campo | Descrição |
|---|---|
url | Endereço da página de conexão, para abrir no navegador do cliente |
token | Token do link, já incluído na url |
expires_in | Validade do link, em segundos |
Autorizações
Token de conta gerado no painel da Datafy, na aba Parceiros. Formato: sk_acct_xxx. Diferente do token de canal (sk_live_).
Parâmetros de caminho
ID do canal, retornado em Listar canais e em Criar canal.