authentication.mdx

title	Autenticação
description	Como gerar e utilizar suas credenciais de API no Hub Message

import { projectName, frontendUrl } from '/snippets/variables.mdx';

Credenciais da API

O {projectName} trabalha com um par de chaves: Public Key e Secret Key. Ambas são geradas no menu Segurança do painel: Segurança.

---

Public Key

A Public Key é utilizada pelo SDK de conexão de canais (@hubmessage/connect). Com ela, você pode conectar canais diretamente dentro do seu sistema, sem precisar acessar o painel.

A Public Key pode ser exposta no frontend da sua aplicação, pois ela tem permissões limitadas apenas à conexão de canais.

Exemplo de uso:

import HubMessage from '@hubmessage/connect';

const client = HubMessage.newClient({
  publicKey: 'SUA_PUBLIC_KEY'
});

---

Secret Key

A Secret Key é utilizada para autenticação em todas as APIs do {projectName}. Ela deve ser enviada no header Authorization como Bearer token em toda requisição.

A Secret Key **nunca** deve ser exposta no frontend. Utilize-a apenas no backend da sua aplicação.

Exemplo de uso:

curl -X GET https://api.hubmessage.io/whatsapp/businesses \
  -H "Authorization: Bearer SUA_SECRET_KEY"

---

Resumo

Chave	Uso	Onde usar	Pode expor no frontend?
Public Key	SDK de conexão de canais	Frontend ou backend	Sim
Secret Key	Todas as chamadas de API (canais, templates, mensagens)	Apenas backend	Não

Próximos passos

Crie seu primeiro canal para começar a enviar mensagens. Integre o fluxo de conexão no seu sistema.