Configuração: Configurado diretamente na integração do Bot no nexus-chat
Dispara quando uma nova mensagem é encaminhada a um bot integrado ao nexus-chat. Permite integrar sistemas de atendimento automático com a plataforma do Nexus.
Campo Tipo Descrição event_idstring (uuid) Identificador único do evento (UUID v4). typestring Sempre "message" neste webhook. messageobject Dados da mensagem recebida. ticketobject Dados do ticket associado. whatsappobject Dados do WhatsApp que recebeu a mensagem. contactobject Dados do contato remetente. contextobject Variáveis de contexto personalizadas.
Campo Tipo Descrição idstring ID da mensagem no sistema. fromstring Número de origem (cliente). tostring Número de destino (bot/empresa). from_meboolean Se foi enviada pelo atendente/bot. from_botboolean Se foi enviada por um bot. user_idinteger | null ID do usuário que enviou. typestring Tipo da mensagem (text, image, etc). textstring Conteúdo textual da mensagem. postback_textstring | null Texto de callback de Quick Reply. filestring | null URL do arquivo enviado. datetimestring (date-time) Data e hora do envio.
Campo Tipo Descrição idinteger ID do ticket. uuidstring UUID do ticket. tracking_idinteger Código de rastreamento. campaign_idinteger | null ID da campanha associada. request_idstring | null ID da requisição original. cost_center_idinteger | null ID do centro de custo. statusstring Status atual do ticket. user_idinteger | null ID do usuário atendente. contact_idinteger ID do contato. queue_idinteger ID da fila de atendimento. transfer_queue_idinteger ID da fila de transferência. whatsapp_idinteger ID do número do ticket. integration_idinteger | null ID da integração. from_meboolean Se o atendimento foi iniciado pelo sistema.
Campo Tipo Descrição idinteger ID do número de WhatsApp. namestring Nome da empresa/entidade. numberstring Número do WhatsApp.
Campo Tipo Descrição idinteger ID do contato. namestring Nome do contato. numberstring Número de telefone. documentstring | null Documento (CPF/CNPJ). emailstring | null Email do contato. is_groupboolean Se é um grupo. created_atstring (date-time) Data de criação. updated_atstring (date-time) Data de atualização. extra_infoarray Lista de dados adicionais.
JSON
{
"event_id": "j50h2i30-sg2p-g5r8-o150-ii0099ii4444",
"type": "message",
"message": {
"id": "00wamid.HBgMNUMyMDAwMDAwMDAwFQIAEhgUAAAAAAAABBBBCCCCDDDDEEEEFFFF000011112222",
"from": "559999999999",
"to": "5511999999999",
"from_me": false,
"from_bot": false,
"user_id": null,
"type": "text",
"text": "QUERO MAIS",
"postback_text": null,
"file": null,
"datetime": "2025-07-21T14:54:36.487-03:00"
},
"ticket": {
"id": 12345,
"uuid": "abcd1234-abcd-1234-abcd-1234567890ab",
"tracking_id": 987654,
"campaign_id": 10,
"request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"cost_center_id": 1,
"status": "pending",
"user_id": null,
"contact_id": 54321,
"queue_id": 5,
"transfer_queue_id": 2,
"whatsapp_id": 3,
"integration_id": 1,
"from_me": false
},
"whatsapp": {
"id": 3,
"name": "Empresa Fictícia Tecnologia Ltda",
"number": "5511999999999"
},
"contact": {
"id": 54321,
"name": "João da Silva",
"number": "559999999999",
"document": "00000000000",
"email": "[email protected] ",
"is_group": false,
"created_at": "2024-01-01T10:00:00.000Z",
"updated_at": "2025-07-21T17:54:16.843Z",
"extra_info": [
{
"id": 1,
"name": "idade",
"value": "30"
},
{
"id": 2,
"name": "cidade",
"value": "São Paulo"
}
]
},
"context": {
"custom_1": "valor1",
"custom_2": "valor2",
"custom_3": "valor3"
}
}
Quando o usuário clica em um botão de Quick Reply, o campo postback_text contém o valor configurado no botão.
JSON
{
"event_id": "l70j4k50-ui4r-i7t0-q372-kk2211kk6666",
"type": "message",
"message": {
"id": "00wamid.HBgMNUMyMDAwMDAwMDAwFQIAEhgUAAAAAAAABBBBCCCCDDDDEEEEFFFF000011112223",
"from": "559999999999",
"to": "5511999999999",
"from_me": false,
"from_bot": false,
"user_id": null,
"type": "text",
"text": "Suporte Técnico",
"postback_text": "support",
"file": null,
"datetime": "2025-07-21T14:54:36.487-03:00"
},
"ticket": {
"id": 12345,
"uuid": "abcd1234-abcd-1234-abcd-1234567890ab",
"tracking_id": 987654,
"campaign_id": 10,
"request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"cost_center_id": 1,
"status": "pending",
"user_id": null,
"contact_id": 54321,
"queue_id": 5,
"transfer_queue_id": 2,
"whatsapp_id": 3,
"integration_id": 1,
"from_me": false
},
"whatsapp": {
"id": 3,
"name": "Empresa Fictícia Tecnologia Ltda",
"number": "5511999999999"
},
"contact": {
"id": 54321,
"name": "João da Silva",
"number": "559999999999",
"document": "00000000000",
"email": "[email protected] ",
"is_group": false,
"created_at": "2024-01-01T10:00:00.000Z",
"updated_at": "2025-07-21T17:54:16.843Z",
"extra_info": [
{
"id": 1,
"name": "idade",
"value": "30"
}
]
},
"context": {
"custom_1": "valor1"
}
}
Dispara quando uma nova mensagem é encaminhada a um bot integrado ao nexus-chat. Permite integrar sistemas de atendimento automático com a plataforma do Nexus.
Campo Tipo Descrição event_idstring (uuid) Identificador único do evento (UUID v4). typestring Sempre "message" neste webhook. messageobject Dados da mensagem recebida. ticketobject Dados do ticket associado. whatsappobject Dados do WhatsApp que recebeu a mensagem. contactobject Dados do contato remetente. contextobject Variáveis de contexto personalizadas.
Campo Tipo Descrição idstring ID da mensagem no sistema. fromstring Número de origem (cliente). tostring Número de destino (bot/empresa). from_meboolean Se foi enviada pelo atendente/bot. from_botboolean Se foi enviada por um bot. user_idinteger | null ID do usuário que enviou. typestring Tipo da mensagem (text, image, etc). textstring Conteúdo textual da mensagem. postback_textstring | null Texto de callback de Quick Reply. filestring | null URL do arquivo enviado. datetimestring (date-time) Data e hora do envio.
Campo Tipo Descrição idinteger ID do ticket. uuidstring UUID do ticket. tracking_idinteger Código de rastreamento. campaign_idinteger | null ID da campanha associada. request_idstring | null ID da requisição original. cost_center_idinteger | null ID do centro de custo. statusstring Status atual do ticket. user_idinteger | null ID do usuário atendente. contact_idinteger ID do contato. queue_idinteger ID da fila de atendimento. transfer_queue_idinteger ID da fila de transferência. whatsapp_idinteger ID do número do ticket. integration_idinteger | null ID da integração. from_meboolean Se o atendimento foi iniciado pelo sistema.
Campo Tipo Descrição idinteger ID do número de WhatsApp. namestring Nome da empresa/entidade. numberstring Número do WhatsApp.
Campo Tipo Descrição idinteger ID do contato. namestring Nome do contato. numberstring Número de telefone. documentstring | null Documento (CPF/CNPJ). emailstring | null Email do contato. is_groupboolean Se é um grupo. created_atstring (date-time) Data de criação. updated_atstring (date-time) Data de atualização. extra_infoarray Lista de dados adicionais.
JSON
{
"event_id": "j50h2i30-sg2p-g5r8-o150-ii0099ii4444",
"type": "message",
"message": {
"id": "00wamid.HBgMNUMyMDAwMDAwMDAwFQIAEhgUAAAAAAAABBBBCCCCDDDDEEEEFFFF000011112222",
"from": "559999999999",
"to": "5511999999999",
"from_me": false,
"from_bot": false,
"user_id": null,
"type": "text",
"text": "QUERO MAIS",
"postback_text": null,
"file": null,
"datetime": "2025-07-21T14:54:36.487-03:00"
},
"ticket": {
"id": 12345,
"uuid": "abcd1234-abcd-1234-abcd-1234567890ab",
"tracking_id": 987654,
"campaign_id": 10,
"request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"cost_center_id": 1,
"status": "pending",
"user_id": null,
"contact_id": 54321,
"queue_id": 5,
"transfer_queue_id": 2,
"whatsapp_id": 3,
"integration_id": 1,
"from_me": false
},
"whatsapp": {
"id": 3,
"name": "Empresa Fictícia Tecnologia Ltda",
"number": "5511999999999"
},
"contact": {
"id": 54321,
"name": "João da Silva",
"number": "559999999999",
"document": "00000000000",
"email": "[email protected] ",
"is_group": false,
"created_at": "2024-01-01T10:00:00.000Z",
"updated_at": "2025-07-21T17:54:16.843Z",
"extra_info": [
{
"id": 1,
"name": "idade",
"value": "30"
},
{
"id": 2,
"name": "cidade",
"value": "São Paulo"
}
]
},
"context": {
"custom_1": "valor1",
"custom_2": "valor2",
"custom_3": "valor3"
}
}
Quando o usuário clica em um botão de Quick Reply, o campo postback_text contém o valor configurado no botão.
JSON
{
"event_id": "l70j4k50-ui4r-i7t0-q372-kk2211kk6666",
"type": "message",
"message": {
"id": "00wamid.HBgMNUMyMDAwMDAwMDAwFQIAEhgUAAAAAAAABBBBCCCCDDDDEEEEFFFF000011112223",
"from": "559999999999",
"to": "5511999999999",
"from_me": false,
"from_bot": false,
"user_id": null,
"type": "text",
"text": "Suporte Técnico",
"postback_text": "support",
"file": null,
"datetime": "2025-07-21T14:54:36.487-03:00"
},
"ticket": {
"id": 12345,
"uuid": "abcd1234-abcd-1234-abcd-1234567890ab",
"tracking_id": 987654,
"campaign_id": 10,
"request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"cost_center_id": 1,
"status": "pending",
"user_id": null,
"contact_id": 54321,
"queue_id": 5,
"transfer_queue_id": 2,
"whatsapp_id": 3,
"integration_id": 1,
"from_me": false
},
"whatsapp": {
"id": 3,
"name": "Empresa Fictícia Tecnologia Ltda",
"number": "5511999999999"
},
"contact": {
"id": 54321,
"name": "João da Silva",
"number": "559999999999",
"document": "00000000000",
"email": "[email protected] ",
"is_group": false,
"created_at": "2024-01-01T10:00:00.000Z",
"updated_at": "2025-07-21T17:54:16.843Z",
"extra_info": [
{
"id": 1,
"name": "idade",
"value": "30"
}
]
},
"context": {
"custom_1": "valor1"
}
}