Sincronizar histórico
curl --request POST \
--url https://cloud.datafyapi.com.br/v1/{phone_number_id}/smb_app_data \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"messaging_product": "whatsapp",
"sync_type": "history"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({messaging_product: 'whatsapp', sync_type: 'history'})
};
fetch('https://cloud.datafyapi.com.br/v1/{phone_number_id}/smb_app_data', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/v1/{phone_number_id}/smb_app_data"
payload = {
"messaging_product": "whatsapp",
"sync_type": "history"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"messaging_product": "whatsapp",
"request_id": "7a3b2c1d-e5f6-4a8b-9c0d-1e2f3a4b5c6d",
"success": true
}{
"error": {
"message": "Invalid parameter",
"type": "OAuthException",
"code": 100,
"fbtrace_id": "AbCdEfGhIjK"
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}Conta e número
Sincronizar histórico
Solicita o envio do histórico de conversas do aplicativo do WhatsApp Business. Os dados chegam pelo webhook history.
POST
/
v1
/
{phone_number_id}
/
smb_app_data
Sincronizar histórico
curl --request POST \
--url https://cloud.datafyapi.com.br/v1/{phone_number_id}/smb_app_data \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"messaging_product": "whatsapp",
"sync_type": "history"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({messaging_product: 'whatsapp', sync_type: 'history'})
};
fetch('https://cloud.datafyapi.com.br/v1/{phone_number_id}/smb_app_data', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/v1/{phone_number_id}/smb_app_data"
payload = {
"messaging_product": "whatsapp",
"sync_type": "history"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"messaging_product": "whatsapp",
"request_id": "7a3b2c1d-e5f6-4a8b-9c0d-1e2f3a4b5c6d",
"success": true
}{
"error": {
"message": "Invalid parameter",
"type": "OAuthException",
"code": 100,
"fbtrace_id": "AbCdEfGhIjK"
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}Quando um número é conectado por coexistência, as conversas anteriores continuam apenas no aplicativo do WhatsApp Business, no celular. Esta chamada pede à Meta que envie esse histórico para a sua aplicação.
A resposta apenas confirma o aceite do pedido. Os dados não vêm nela: chegam depois, pelo webhook Histórico de conversas, divididos em várias entregas.
O histórico pode ser solicitado uma única vez. Repetir a chamada não gera um novo envio.
Os contatos da agenda são solicitados separadamente, em Sincronizar contatos.
O procedimento completo está na documentação de onboarding da Meta.
{
"messaging_product": "whatsapp",
"request_id": "7a3b2c1d-e5f6-4a8b-9c0d-1e2f3a4b5c6d",
"success": true
}
A chamada precisa ser feita em até 24 horas após a conexão do número. Passado esse prazo, o pedido não tem efeito, e a única forma de recuperar o histórico é desconectar o número e refazer a conexão.
Antes de chamar
O eventohistory precisa estar marcado para a sua URL antes do disparo, senão os dados são enviados e não há para onde entregar. No painel da Datafy, na aba Webhooks do número, marque history na URL que vai receber.
curl -X POST 'https://cloud.datafyapi.com.br/v1/{phone_number_id}/smb_app_data' \
-H 'Authorization: Bearer sk_live_xxx' \
-H 'Content-Type: application/json' \
-d '{ "messaging_product": "whatsapp", "sync_type": "history" }'
O que chega
As conversas são entregues em vários blocos pelo webhookhistory, com até 180 dias de mensagens, acompanhados dos campos phase, chunk_order e progress para o progresso. Mensagens que continham mídia chegam apenas como marcador: o arquivo não é sincronizado.
Os blocos podem chegar fora de ordem e em grande volume — milhares de entregas em poucos minutos —, e uma entrega que falha é reenviada automaticamente. Por isso a sua aplicação deve responder 200 de imediato, tratar as entregas de forma idempotente pelo x-datafy-delivery-id e reordenar pelo chunk_order e pelo timestamp de cada mensagem.
O formato completo, o acompanhamento do progresso e o comportamento de reentrega estão em Histórico de conversas.
Guarde o
request_id da resposta. Ele é o identificador do pedido junto à Meta, necessário caso seja preciso abrir um chamado por dados que não chegaram.Autorizações
Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.
Parâmetros de caminho
ID do número conectado por coexistência. Descubra com GET /me.
Corpo
application/json
Resposta
Sincronização aceita. Os dados chegam pelos webhooks.