LunaDocumentaçãoEntrar

Documentação da Luna

A Luna é uma API de mensageria para WhatsApp, construída sobre a WhatsApp Cloud API oficial da Meta. A Helsen opera como Tech Provider aprovado, e nenhuma biblioteca não oficial participa do caminho. A Luna entrega a infraestrutura de mensageria, e o que acontece dentro da conversa é do seu produto.

O caminho, do zero à primeira mensagem

  1. Crie a conta no console. Você confirma o e-mail e entra.
  2. Conecte um número. O dono do número autoriza na janela da Meta. Conectar um número
  3. Crie uma chave de API no console, com só os escopos de que você precisa. Primeiros passos
  4. Cadastre um webhook e verifique a assinatura. Receber eventos
  5. Envie uma mensagem. Enviar mensagens

Se você prefere seguir de uma vez, Primeiros passos percorre os cinco passos com exemplos que rodam.

Os guias

  • Primeiros passos: de uma conta nova a uma mensagem enviada e a um evento recebido.
  • Conectar um número: número novo, número que continua no aplicativo WhatsApp Business do celular (coexistência) e número que vem de outro provedor.
  • Receber eventos: o endpoint, cada tipo de evento, as garantias de entrega, retentativas, reenvio e a verificação da assinatura.
  • Enviar mensagens: cada tipo de mensagem, a janela de 24 horas, idempotência e o acompanhamento da entrega.
  • Templates: criar, acompanhar o estado, cabeçalho de mídia e o que muda entre aprovado e liberado.
  • Erros: o formato do erro, os códigos principais, o que fazer em cada um e os cabeçalhos de limite.

A referência da API

Os guias explicam o caminho. O contrato de cada rota, campo a campo, está na referência da API, gerada da mesma definição que valida as requisições. A especificação OpenAPI 3.1 está em openapi.json. Se um guia divergir da referência, vale a referência.

Toda chamada leva uma chave de API no cabeçalho Authorization, no formato Bearer hlsn_.... A base é https://api.lunahia.com.br, e todas as rotas ficam sob /v1.

O que a Luna cobra, e o que a Meta cobra

A Luna cobra pela capacidade de números ativos do plano, e por nada além disso. O uso da plataforma WhatsApp é cobrado pela Meta, diretamente do negócio final, no método de pagamento que ele cadastra na conta dele. A Helsen não intermedeia esse pagamento. Os planos estão em Preços.