Digite para filtrar os verbetes do Glossário.

    Automação e integrações · n8n Experts

    O que é protobuf?

    O Protobuf serializa mensagens em bytes usando campos numerados. A definição da mensagem permite interpretar os valores e orientar mudanças compatíveis.

    Também chamado de: Protocol Buffers, Protocol Buffer

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Da definição aos bytes

    O Protobuf, abreviação de Protocol Buffers, é um mecanismo de serialização que converte mensagens estruturadas em bytes e permite reconstruí-las depois. Você descreve os campos em um arquivo .proto e pode gerar código para ler e escrever as mensagens em linguagens compatíveis.

    Cada campo recebe um número que o identifica no formato binário. A mensagem também carrega informações sobre como seus valores estão codificados, mas os nomes e os tipos declarados vêm da definição. Por isso, o receptor precisa conhecer a definição correspondente para interpretar o conteúdo como a aplicação espera. O arquivo .proto não acompanha automaticamente cada mensagem.

    Um campo numerado no relatório

    Esta definição didática declara uma mensagem com um campo de texto chamado titulo e atribui a ele o número 1:

    syntax = "proto3";
    message Relatorio {
    string titulo = 1;
    }

    Ao serializar o texto "Vendas de novembro" nesse campo, o Protobuf usa o número 1 para identificá-lo nos bytes. O decodificador usa a definição de Relatorio para associar o conteúdo ao título, embora o nome titulo não esteja escrito na mensagem binária.

    Uma integração que apenas encaminha esse relatório deve preservar os bytes recebidos. Interpretar a resposta binária como texto e gravá-la novamente pode alterar o conteúdo. Caracteres ilegíveis no editor de texto são esperados nesse formato e não demonstram uma falha na transferência.

    Compatibilidade entre versões

    Uma versão nova precisa preservar o significado dos números já usados. Ao remover o campo titulo, você deve reservar o número 1 com uma declaração reserved na definição. Reutilizar esse número para outro campo pode causar uma leitura incorreta de mensagens antigas.

    O formato permite algumas alterações compatíveis, como a adição de campos, sob as condições descritas no guia oficial. Isso não torna toda mudança compatível. Compare as definições dos dois serviços e teste a leitura entre as versões que precisam se comunicar.

    Dúvidas frequentes

    Perguntas frequentes sobre protobuf

    Uma mensagem Protobuf é um documento JSON?
    O formato binário e o JSON são representações diferentes. O Protobuf tem um mapeamento chamado ProtoJSON, mas a conversão exige um serializador apropriado. Ler os bytes como texto não produz JSON.
    A mensagem binária inclui os nomes dos campos?
    Os campos são identificados por números no formato binário. A definição da mensagem associa cada número ao nome e ao tipo declarado. Essa definição precisa estar disponível ao decodificador.
    Posso reutilizar o número de um campo removido?
    A documentação orienta reservar esse número com reserved. Reutilizá-lo pode fazer uma mensagem antiga ser interpretada com outro significado ou causar erro de leitura.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    n8n Experts

    Uma integração precisa reconhecer o formato da resposta para preservar e interpretar corretamente o conteúdo recebido.

    Conhecer a formação
    Capa da formação n8n Experts

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano