Criar webhook
curl --request POST \
--url https://cloud.datafyapi.com.br/channels/instagram/{id}/webhooks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "https://exemplo.com/webhook",
"events": [
"messages"
],
"enabled": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: 'https://exemplo.com/webhook', events: ['messages'], enabled: true})
};
fetch('https://cloud.datafyapi.com.br/channels/instagram/{id}/webhooks', 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}/webhooks"
payload = {
"url": "https://exemplo.com/webhook",
"events": ["messages"],
"enabled": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "9d8c7b6a-5f4e-4d3c-2b1a-0f9e8d7c6b5a",
"url": "https://exemplo.com/webhook",
"events": [
"messages"
],
"enabled": true
}Webhooks do canal
Criar webhook
Cadastra uma URL para receber os eventos do canal.
POST
/
channels
/
instagram
/
{id}
/
webhooks
Criar webhook
curl --request POST \
--url https://cloud.datafyapi.com.br/channels/instagram/{id}/webhooks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "https://exemplo.com/webhook",
"events": [
"messages"
],
"enabled": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: 'https://exemplo.com/webhook', events: ['messages'], enabled: true})
};
fetch('https://cloud.datafyapi.com.br/channels/instagram/{id}/webhooks', 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}/webhooks"
payload = {
"url": "https://exemplo.com/webhook",
"events": ["messages"],
"enabled": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "9d8c7b6a-5f4e-4d3c-2b1a-0f9e8d7c6b5a",
"url": "https://exemplo.com/webhook",
"events": [
"messages"
],
"enabled": true
}Resposta
| Campo | Descrição |
|---|---|
id | ID do webhook |
url | URL que recebe os eventos |
events | Eventos que o webhook recebe |
enabled | Indica se o webhook está ativo |
Eventos disponíveis
Valores aceitos emevents. Se o campo não for enviado, o webhook recebe messages.
| Evento | Descrição |
|---|---|
messages | Mensagem recebida no direct, incluindo as mensagens que a própria conta envia (is_echo) |
messaging_postbacks | Clique em botão de resposta rápida ou ice breaker |
messaging_referral | Conversa aberta por link ig.me com parâmetro ref |
messaging_seen | Confirmação de leitura das mensagens enviadas |
message_reactions | Reação adicionada ou removida em uma mensagem |
message_edit | Mensagem editada pelo remetente |
messaging_optins | Opt-in de notification messages, que permite enviar fora da janela de 24 horas |
messaging_handover | Passagem de controle da conversa entre aplicativos |
standby | Mensagens que chegam enquanto outro aplicativo tem o controle da conversa |
comments | Comentários em posts e reels da conta |
live_comments | Comentários durante uma transmissão ao vivo |
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.
Corpo
application/json
URL que recebe os eventos. Precisa usar HTTPS.
Exemplo:
"https://exemplo.com/webhook"
Eventos que o webhook recebe. Se omitido, recebe messages. Não pode ser uma lista vazia.
Opções disponíveis:
messages, messaging_postbacks, messaging_referral, messaging_seen, message_reactions, message_edit, messaging_optins, messaging_handover, standby, comments, live_comments Exemplo:
["messages"]
Ativa ou desativa o webhook.
Exemplo:
true