Skip to main content
A integração via Webhook permite comunicação em tempo quase real entre o Invenio Center, o Invenio Live e sistemas externos. Eventos importantes são enviados automaticamente para o endpoint configurado, permitindo que sua operação registre, trate e analise dados de forma ágil e integrada.
Os dados são enviados em lotes de até 30 arquivos JSON, com intervalo médio de 2 segundos entre os lotes.
⚠️ Importante: A Robbu não realiza integrações customizadas com APIs dos clientes no contexto de webhooks.A plataforma envia os dados em tempo real para endpoints previamente definidos, sendo o consumo, processamento e tratamento dessas informações de responsabilidade da empresa responsável pela integração.

Eventos Disponíveis

Objetos JSON enviados: contact · event · messageincoming · messageoutgoing · campaign · template · protocol · wallet · whatsappnumbers · status

Linguagens Suportadas

Os webhooks do Invenio são baseados em HTTP — qualquer linguagem que suporte servidor web pode ser utilizada.

Requisitos de Infraestrutura (Produção)

Configuração mínima recomendada para o servidor endpoint:⚠️ O uso de HD não é recomendado — pode gerar gargalos pelo alto volume de mensagens e eventos. Monitore a infraestrutura continuamente com possibilidade de escala futura.

Configurar o Webhook no Invenio Center

Caminho: Invenio Center > Configurações > Webhook > Gerenciar
Acesso direto: Configurações
1

Preparar o servidor endpoint

Configure e publique o endpoint na sua infraestrutura (servidor, banco de dados, firewall).Certifique-se de que os IPs do Invenio estão liberados no firewall.Consulte: Lista de IPs para liberação
2

Acessar configurações do Webhook

Acesse: Invenio Center > Configurações > Webhook > Gerenciar

Tela de gerenciamento do Webhook

Configuração da URL do endpoint

Confirmação de configuração salva

3

Adicionar a URL do endpoint

Cole a URL gerada pelo seu servidor/ambiente de publicação no campo disponível e clique em Salvar.
Em até 60 minutos, as requisições começarão a ser disparadas para o endpoint configurado.
Fila paralela: O Invenio disponibiliza dois campos para URLs de Webhook por padrão. A inclusão de URLs adicionais (fila paralela) está sujeita a custo extra — consulte o gerente comercial responsável pela sua conta.

Diagrama de Funcionamento


Mapeamento de Campos

Message (Mensagem)

Reúne todas as informações relacionadas às mensagens trafegadas no contato, tanto de entrada quanto de saída. Inclui o conteúdo da mensagem, identificadores únicos para rastreio e dados como data, hora e canal de envio, permitindo o acompanhamento completo das interações. Enumeração – MessageChannel: 1 E-mail · 2 SMS · 3 WhatsApp · 4 Chat · 5 Facebook · 6 Telegram · 7 Voz · 8 Instagram · 9 Viber

Status

Responsável por informar o estado atual da mensagem ao longo do seu ciclo de vida. Contempla informações como status de envio (enviado, entregue, lido ou falha), além de datas e horários relevantes de cada etapa, permitindo o monitoramento completo da evolução da mensagem.

Event (KPI Evento)

Reúne os dados de eventos da plataforma, incluindo eventos sistêmicos e personalizados, utilizados no mapeamento do fluxo de comunicação. Esses eventos representam ações ou gatilhos que influenciam o comportamento e o processamento das interações.

Campaign (Campanha)

Apresenta os dados da campanha disparada, contemplando informações da campanha em si, e não das mensagens individuais. Inclui identificador, canal, tipo, datas, volume de envio, status e dados do mailing, além de informações de criação e configuração, permitindo acompanhar e analisar o desempenho da campanha. Enumeração – Channel: 1 E-mail · 2 SMS · 3 WhatsApp · 4 Chat · 5 Facebook · 6 Telegram · 7 Voz · 8 Instagram · 9 Viber TypeCampaignCode: EM E-mail · SL SMS Long · SS SMS Short · VW Voz Way · WB WhatsApp Broadcast · WE WhatsApp Oficial Exclusivo · WP WhatsApp Prospect · WO/WC WhatsApp Oficial Compartilhado CampaignStatusCode: C Cancelada · E Não enviada · F Finalizada · I Iniciada · P Aguardando processamento

Template

Contém os dados do template, sem relação direta com envios de mensagens. Apresenta informações de identificação e estrutura, além de eventos como criação, alterações e mudanças de status ao longo do seu ciclo de vida.

Protocol (Protocolo)

Refere-se ao identificador do atendimento, vinculando a mensagem a um protocolo específico. Permite organizar e rastrear conversas, trazendo dados como ID do protocolo, data de criação, status e informações de encerramento do atendimento.

User (Usuário)

Apresenta os dados do usuário na plataforma, de forma independente das interações com mensagens. Contempla informações relacionadas à identificação e ao perfil do usuário, além de eventos como criação, atualização e grupos de acesso, permitindo o acompanhamento e controle operacional.

Wallet (Carteira / Segmento)

Representa os dados da carteira (segmento) na plataforma, de forma independente dos envios de mensagens. Inclui informações de identificação e configuração, além de eventos como criação e atualização, permitindo o gerenciamento e a organização dos segmentos.

WhatsApp Numbers (Linhas WhatsApp)

Contém os dados dos números de WhatsApp cadastrados na plataforma, de forma independente das mensagens. Inclui informações cadastrais, configurações e o histórico de alterações, como atualizações e mudanças de status ao longo do tempo.

Configurações Gerais da Conta

Configurações do ambiente Invenio Center

Lista de IPs para Firewall

IPs que devem ser liberados no firewall

⁉️ Perguntas Frequentes (FAQ)

São enviados blocos JSON dos seguintes objetos: contact · event · messageincoming · messageoutgoing · campaign · template · protocol · wallet · whatsappnumbers · status
Em lotes de até 30 arquivos JSON com intervalo médio de 2 segundos entre os lotes.
Em até 60 minutos após o salvamento da URL do endpoint no Invenio Center.
É altamente recomendado usar HTTPS para segurança no transporte dos dados. Além disso, libere os IPs oficiais do Invenio no firewall para garantir conectividade.Consulte: Lista de IPs
Para ambientes de produção: SSD 250 GB · 16 GB RAM · CPU 4 núcleos.⚠️ HD não é recomendado pelo alto volume de eventos. Preveja escalabilidade futura.
Sim. A solução é compatível com ambos — a tecnologia do banco de dados e infraestrutura ficam a critério do cliente, desde que a TI garanta operação e manutenção.
A fila paralela permite configurar URLs adicionais além das duas padrão. Essa configuração pode gerar cobrança adicional — consulte o gerente comercial responsável pela sua conta.
Caminho: Invenio Center > Configurações > Webhook > GerenciarApós publicar o serviço e liberar o firewall, informe a URL do endpoint e salve.