Configurar webhook global
curl --request PUT \
--url https://cloud.datafyapi.com.br/channels/instagram/global-webhook \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "https://exemplo.com/webhook-global",
"events": [
"messages"
],
"enabled": true
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: 'https://exemplo.com/webhook-global', events: ['messages'], enabled: true})
};
fetch('https://cloud.datafyapi.com.br/channels/instagram/global-webhook', 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/global-webhook"
payload = {
"url": "https://exemplo.com/webhook-global",
"events": ["messages"],
"enabled": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"webhook": {
"url": "https://exemplo.com/webhook-global",
"events": [
"messages"
],
"enabled": true,
"secret": "whsec_xxx"
}
}Webhook global
Configurar webhook global
Cria ou substitui o webhook global da conta. O corpo define o webhook inteiro: os campos omitidos voltam ao valor padrão.
PUT
/
channels
/
instagram
/
global-webhook
Configurar webhook global
curl --request PUT \
--url https://cloud.datafyapi.com.br/channels/instagram/global-webhook \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "https://exemplo.com/webhook-global",
"events": [
"messages"
],
"enabled": true
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: 'https://exemplo.com/webhook-global', events: ['messages'], enabled: true})
};
fetch('https://cloud.datafyapi.com.br/channels/instagram/global-webhook', 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/global-webhook"
payload = {
"url": "https://exemplo.com/webhook-global",
"events": ["messages"],
"enabled": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"webhook": {
"url": "https://exemplo.com/webhook-global",
"events": [
"messages"
],
"enabled": true,
"secret": "whsec_xxx"
}
}O webhook global é um destino único que recebe os eventos de todos os canais de Instagram da conta, sem precisar configurar um webhook em cada canal.
Como funciona
- A conta tem um webhook global para Instagram, separado do webhook global de WhatsApp.
- Ele funciona junto com os webhooks dos canais: um evento é entregue no webhook global e no webhook do canal. Se os dois apontam para a mesma URL, ela recebe o mesmo evento duas vezes, cada entrega assinada com o secret correspondente.
- As entregas são assinadas com o
secretdo próprio webhook global, no mesmo esquema de assinatura dos webhooks dos canais. O secret é gerado na primeira configuração e mantido nas substituições seguintes; para trocá-lo, use Rotacionar secret global.
Diferente da edição dos webhooks dos canais, esta chamada substitui o webhook inteiro. Campos omitidos voltam ao valor padrão:
events passa a ser messages, e enabled passa a ser true.Resposta
| Campo | Descrição |
|---|---|
webhook.url | URL que recebe os eventos de todos os canais |
webhook.events | Eventos que o webhook recebe |
webhook.enabled | Indica se o webhook está ativo |
webhook.secret | Secret usado na assinatura das entregas deste webhook |
Autorizações
Token de conta gerado no painel da Datafy, na aba Parceiros. Formato: sk_acct_xxx. Diferente do token de canal (sk_live_).
Corpo
application/json
URL que recebe os eventos de todos os canais. Precisa usar HTTPS.
Exemplo:
"https://exemplo.com/webhook-global"
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. Se omitido, fica ativo.
Exemplo:
true
Resposta
Webhook global configurado.
Webhook global da conta, ou null quando não configurado.
Show child attributes
Show child attributes