Gerar link de conexão

curl --request POST \
  --url https://cloud.datafyapi.com.br/channels/whatsapp/{id}/connect-link \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://cloud.datafyapi.com.br/channels/whatsapp/{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/whatsapp/{id}/connect-link"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

{
  "url": "https://app.datafyapi.com.br/c/ct_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
  "token": "ct_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
  "expires_in": 86400
}

POST

channels

{id}

connect-link

Gerar link de conexão

curl --request POST \
  --url https://cloud.datafyapi.com.br/channels/whatsapp/{id}/connect-link \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://cloud.datafyapi.com.br/channels/whatsapp/{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/whatsapp/{id}/connect-link"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

{
  "url": "https://app.datafyapi.com.br/c/ct_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
  "token": "ct_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
  "expires_in": 86400
}

Um canal criado pela API nasce sem número. Esta chamada gera o link que o cliente abre para conectar o WhatsApp dele ao canal.

Como usar o link

Gere o link no seu servidor e abra a url no navegador do cliente, em uma janela nova:

const janela = window.open(url, 'datafy-conexao', 'width=600,height=760')

Janela de conexão aberta para o cliente, com a marca do parceiro e o botão para conectar o WhatsApp.

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.

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 conexão:

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 { phone_number_id, waba_id, business_id, coexistence } = evento.data.data
    // canal conectado
  }

  if (evento.data.event === 'error') {
    // evento.data.message traz o motivo
  }
})

Evento	Conteúdo
`connected`	`data` com `phone_number_id`, `waba_id`, `business_id` e `coexistence`
`error`	`message` com o motivo da falha

O campo coexistence indica que o número foi conectado mantendo o aplicativo do WhatsApp Business em uso. Depois do sucesso, a janela se fecha sozinha. Em caso de erro ela permanece aberta, para o cliente tentar de novo.

Os dados da mensagem já bastam para registrar a conexão. Use Consultar canal quando precisar dos demais campos, como o número exibido e os webhooks, 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.

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

Authorization

string

header

obrigatório

Token de conta gerado no painel da Datafy, em Perfil. Formato: sk_acct_xxx. Diferente do token de canal (sk_live_).

Parâmetros de caminho

string

obrigatório

ID do canal, retornado em Listar canais e em Criar canal.

Resposta

Link de conexão gerado.

url

string

Endereço da página de conexão, para abrir no navegador do cliente.

token

string

Token do link, já incluído na url.

expires_in

integer

Validade do link, em segundos.

Começar

Administração

Mensagens

Recursos de mensagens

Mídias

Templates

Conta e número

Endpoints Datafy

Webhooks

Gerar link de conexão

Como usar o link

Resultado da conexão

Validade

Resposta

Autorizações

Parâmetros de caminho

Resposta

​Como usar o link

​Resultado da conexão

​Validade

​Resposta

Autorizações

Parâmetros de caminho

Resposta

Como usar o link

Resultado da conexão

Validade

Resposta