Developers

Plataforma de developers para integrar, testar e operar

A Sprint 19 transforma a documentacao tecnica em plataforma: docs publicos, sandbox guiado, downloads de SDK e pagina de status. O foco continua pragmatico: contratos curtos, exemplos funcionais e superfícies separadas por responsabilidade.

Abrir sandbox Baixar OpenAPI Ver SDKs

Surfaces

docs.chatbeep.app

/developers

Portal publico para guias, referencia, OpenAPI e contratos de webhooks.

sandbox.chatbeep.app

/developers/sandbox

Playground tecnico com exemplos publicos e ponte para o sandbox autenticado por tenant.

downloads.chatbeep.app

/developers/downloads

Catalogo de artefactos para SDK PHP, Laravel e NodeJS.

status.chatbeep.app

/developers/status

Pagina de estado com health checks do produto e JSON operacional.

Ecosystem

Fundacao publica da plataforma

docs.chatbeep.app

Portal publico para guias, referencia, OpenAPI e contratos de webhooks.

Guias por stack para o widget

Referencia curta para auth, mobile e seguranca

OpenAPI versionado em JSON

sandbox.chatbeep.app

Playground tecnico com exemplos publicos e ponte para o sandbox autenticado por tenant.

Quickstart do widget

Fluxo de login mobile

Exemplos de requests e resposta

downloads.chatbeep.app

Catalogo de artefactos para SDK PHP, Laravel e NodeJS.

Manifestos de pacote

Clientes base prontos a estender

Ficheiros descarregaveis por stack

status.chatbeep.app

Pagina de estado com health checks do produto e JSON operacional.

Database, queue, broadcasting e storage

Ligacao direta ao health JSON

Base para incident communication

Contracts

OpenAPI e webhooks

Contrato OpenAPI publico para widget, mobile, health e webhooks.

OpenAPI JSON

Spec versionada em JSON para widget, mobile, health e verification.

/openapi/chatbeep.v1.json

Webhooks

Eventos principais definidos com envelope versionado e assinatura HMAC.

5 eventos base catalogados

Abrir spec Ver webhooks

SDKs

Artefactos iniciais para parceiros

SDK PHP

Cliente PHP sem framework para widget API, mobile API e health checks.

v0.1.0

composer require chatbeep/sdk-php

SDK Laravel

Wrapper Laravel com Service Provider, configuracao e facade pronta para apps do ecossistema.

v0.1.0

composer require chatbeep/sdk-laravel

SDK NodeJS

Cliente NodeJS com fetch para automacoes, webhooks e operacoes server-to-server.

v0.1.0

npm install @chatbeep/sdk-node

Guides

Instalacao por stack

JavaScript

Instale o widget com um único script e sem dependências.

Open guide

WordPress

Publique o snippet no footer do tema ou via plugin de snippets.

Open guide

Laravel

Inclua o widget diretamente no layout Blade principal.

Open guide

.NET

Inclua o script no layout partilhado da aplicação web.

Open guide

Joomla

Use um módulo HTML personalizado para publicar o widget.

Open guide

Reference

Concepts that must be clear

Authentication

O widget usa token público da instalação. A API mobile usa Bearer token temporário via Sanctum.

Abrir referencia

Pagination

Os endpoints de listagem usam page e per_page, com retorno padrão em meta.

Abrir referencia

Widget API

Fluxo público do widget: carregar config, registar heartbeat, criar visitante, abrir conversa e trocar mensagens.

Abrir referencia

Mobile API

Camada pronta para app iOS/Android, com auth, fila, atribuição, transferência e encerramento.

Abrir referencia

Security

Integração simples, mas com regras explícitas para não expor o sistema.

Abrir referencia

Webhooks

Eventos outbound assinados por HMAC, com envelope versionado para parceiros.

Abrir referencia

Coverage