Visao geral

A API externa do LIP permite que sistemas de clientes enviem mensagens e templates de WhatsApp e recebam eventos via webhooks. Todas as rotas externas ficam abaixo de /api/external.

Base URL

Ambiente atual:

• https://lip-backend-1064145932505.southamerica-east1.run.app

Exemplos:

• https://lip-backend-1064145932505.southamerica-east1.run.app/api/external/whatsapp/messages
• https://lip-backend-1064145932505.southamerica-east1.run.app/api/external/webhooks

Estrutura das rotas

• WhatsApp: /api/external/whatsapp/*
• Webhooks: /api/external/webhooks/*

O que voce pode fazer

• Enviar mensagens de WhatsApp (texto, midia e interativo).
• Enviar templates aprovados pelo WhatsApp.
• Criar, listar, atualizar e remover templates.
• Cadastrar webhooks e receber eventos de WhatsApp, email e campanhas.

Inicio rapido

1. Gere uma API key no painel: Company > API & Webhooks.
2. Envie uma mensagem de teste.
3. Cadastre um webhook para receber eventos.

Exemplo de envio (texto):

Copiar

Resposta esperada:

Copiar

Padrao de resposta

Sucesso:

Copiar

Erro:

Copiar

Regras de telefone (WhatsApp)

A validacao atual e focada em numeros do Brasil.

• Use DDI 55 e numero celular valido.
• A entrada pode conter apenas digitos ou formatos com simbolos; o servidor normaliza.
• Numeros invalidos retornam 400.

Exemplos validos:

• 5511999999999
• +5511999999999
• 11999999999

Proximos passos

• Autenticacao e API Keys: /docs/api-autenticacao
• WhatsApp (mensagens): /docs/api-whatsapp-mensagens
• WhatsApp (templates): /docs/api-whatsapp-templates
• Webhooks: /docs/api-webhooks
• Erros e boas praticas: /docs/api-erros-e-boas-praticas