Padrao de erro

Codigos HTTP comuns

Codigo	Significado	Quando acontece
`200`	OK	Leitura ou operacao sincrona bem-sucedida
`201`	Criado	Recurso criado (template, campanha, webhook)
`202`	Aceito	Envio enfileirado — resultado vem depois
`400`	Requisicao invalida	Payload invalido ou campo obrigatorio ausente
`401`	Nao autenticado	API key invalida ou nao informada
`403`	Sem permissao	Escopo insuficiente para a operacao
`404`	Nao encontrado	Recurso nao existe no workspace
`500`	Erro interno	Falha inesperada no servidor

Exemplos de erro

API key invalida

Payload invalido

Boas praticas

Use HTTPS em todas as requisicoes
Guarde a API key em cofre/secret manager
Restrinja escopos ao minimo necessario
Valide a assinatura HMAC nos webhooks
Registre metadata.eventId para deduplicacao
Armazene X-LIP-Attempt para auditoria de retries

Nunca exponha a API key no front-end

A API key concede acesso total aos escopos do workspace. Use-a apenas em servidores/back-ends. Se vazar, revogue e gere uma nova imediatamente em Company > API & Webhooks.

Tratamento de retries (webhooks)

Responda 2xx somente quando o processamento for bem-sucedido
Responda 4xx/5xx para forcar nova tentativa
Implemente idempotencia usando metadata.eventId

Observabilidade

Salve messageId e conversationId ao enviar mensagens
Logue X-LIP-Event, X-LIP-Timestamp e X-LIP-Attempt

Última atualização

15 de junho de 2026

Editar esta página no GitHub