Payload de webhook de Instagram

Los webhooks de Instagram se envían para mensajes directos, reacciones y confirmaciones de lectura.

Payload de ejemplo

{
"event": {
"id": "evt_ig_abc123",
"channel": "instagram",
"timestamp": 1706640000.0,
"data": {
"timestamp": 1706640000.0,
"direction": "inbound",
"platform": "instagram",
"message_id": "igmid_xyz789",
"chat_id": "chat_456",
"content": "Hey! I saw your post about coaching services",
"is_from_account": false,
"account_id": "acc_123",
"sender_attendee": {
"attendee_id": "att_789",
"attendee_name": "johndoe",
"attendee_provider_id": "17841234567890",
"attendee_profile_url": "https://instagram.com/johndoe"
},
"social_event_type": "message_received",
"attendees": [
{
"attendee_id": "att_789",
"attendee_name": "johndoe",
"attendee_provider_id": "17841234567890"
}
],
"attachments": [],
"usage_data": {
"prompt_tokens": 180,
"completion_tokens": 55,
"model": "gpt-4"
},
"tools_called": [],
"analysis_result": {
"sentiment": "curious",
"intent": "inquiry"
}
}
},
"lead_id": "lead_123",
"lead_contact": {
"number": "",
"email": "",
"name": "johndoe"
},
"business_id": "biz_456",
"lead_created": true
}

Referencia de campos

Campos principales

CampoTipoRequeridoDescripción
timestampfloatMarca de tiempo Unix epoch
directionstringinbound o outbound
platformstringSiempre instagram
message_idstringID de mensaje de Instagram
chat_idstringID del hilo de conversación
contentstringContenido del mensaje
is_from_accountbooleanTrue si fue enviado por la cuenta conectada
account_idstringID de cuenta de Instagram conectada
social_event_typestringTipo de evento

Valores de social_event_type

ValorDescripción
message_receivedNuevo mensaje recibido
message_reactionReacción añadida al mensaje
message_readMensaje marcado como leído
message_editedMensaje fue editado
message_deletedMensaje fue eliminado

Objeto sender_attendee

CampoTipoDescripción
attendee_idstringID interno del asistente
attendee_namestringNombre de usuario de Instagram
attendee_provider_idstringID de usuario de Instagram
attendee_profile_urlstringURL del perfil (opcional)

Campos opcionales

CampoTipoDescripción
attendeesarrayParticipantes de la conversación
attachmentsarrayAdjuntos de medios
usage_dataobjectUso de tokens LLM
tools_calledarrayNombres de herramientas ejecutadas
tool_callsarrayDatos sin procesar de llamadas a herramientas
tool_resultsobjectResultados de ejecución de herramientas
analysis_resultobjectResultado del análisis de IA
appointmentsarrayCitas extraídas
execution_contextobjectContexto del activador de origen
reactionstringEmoji (para reacciones)
reaction_senderobjectInformación del remitente de la reacción

Array de attachments

CampoTipoDescripción
idstringID del adjunto
typestringimage, video, audio, story_mention, reel
urlstringURL de descarga
mimetypestringTipo MIME
unavailablebooleanTrue si expiró
sizeobjectDimensiones

Los prospectos de Instagram pueden no tener teléfono o correo inicialmente. Usa la conversación para recopilar información de contacto.