API Poderosa paraDesenvolvedores

Integre a Senger em suas aplicações com nossa API RESTful completa. Documentação clara, exemplos práticos e suporte dedicado.

Começar Agora Ver Exemplos

Primeiros Passos

Configure sua integração em minutos

1. Obtenha sua API Key

Acesse seu painel de controle e gere uma nova API key na seção "Integrações".

API_KEY: sk_live_1234567890abcdef...

2. Configure a Autenticação

Todas as requisições devem incluir o header de autorização:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

3. Faça sua Primeira Requisição

Teste a conexão com um simples GET request:

curl -X GET https://api.senger.com/v1/me   -H "Authorization: Bearer YOUR_API_KEY"

Response Example

{
  "id": "user_1234567890",
  "name": "Sua Empresa",
  "email": "contato@suaempresa.com",
  "plan": "professional",
  "chatbots": [
    {
      "id": "bot_abc123",
      "name": "Atendimento",
      "status": "active",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "usage": {
    "messages_sent": 1250,
    "messages_limit": 5000,
    "reset_date": "2024-02-01T00:00:00Z"
  }
}

Principais Endpoints

Explore nossa API completa

POST/v1/messages

Envie mensagens para seus contatos via chatbot.

Parâmetros:

recipientID do destinatário

messageConteúdo da mensagem

typeTipo: text, image, file

Exemplo:

{
  "recipient": "user_123",
  "message": "Olá! Como posso ajudar?",
  "type": "text"
}

GET/v1/chatbots

Liste todos os seus chatbots e suas configurações.

Parâmetros opcionais:

statusactive, inactive, all

limitNúmero de resultados (max: 100)

Resposta:

{
  "chatbots": [
    {
      "id": "bot_abc123",
      "name": "Atendimento",
      "status": "active",
      "messages_count": 1250
    }
  ],
  "total": 1
}

GET/v1/analytics

Obtenha métricas e relatórios dos seus chatbots.

Parâmetros:

start_dateData inicial (ISO 8601)

end_dateData final (ISO 8601)

chatbot_idID do chatbot (opcional)

Métricas retornadas:

{
  "messages_sent": 1250,
  "messages_received": 980,
  "unique_users": 450,
  "conversion_rate": 0.23,
  "avg_response_time": 1.2
}

SDKs Oficiais

Bibliotecas para suas linguagens favoritas

JavaScript

SDK para Node.js e navegadores

npm install senger-js

Python

SDK para aplicações Python

pip install senger-python

PHP

SDK para aplicações PHP

composer require senger/php

Go

SDK para aplicações Go

go get github.com/senger/go

Exemplos Práticos

Veja como integrar em diferentes cenários

Enviar Mensagem Automática

JavaScript

const senger = require('senger-js');

const client = new senger.Client({
  apiKey: 'YOUR_API_KEY'
});

// Enviar mensagem de boas-vindas
async function sendWelcome(userId) {
  try {
    const response = await client.messages.send({
      recipient: userId,
      message: 'Bem-vindo! Como posso ajudar?',
      type: 'text'
    });
    
    console.log('Mensagem enviada:', response.id);
  } catch (error) {
    console.error('Erro:', error.message);
  }
}

Webhook para Receber Mensagens

Node.js + Express

const express = require('express');
const app = express();

app.use(express.json());

// Endpoint para receber webhooks
app.post('/webhook', (req, res) => {
  const { event, data } = req.body;
  
  if (event === 'message.received') {
    console.log('Nova mensagem:', {
      from: data.sender.id,
      message: data.message.text,
      timestamp: data.timestamp
    });
    
    // Processar mensagem...
  }
  
  res.status(200).send('OK');
});

app.listen(3000);

Limites e Quotas

Entenda os limites da API

Rate Limits

Requisições por minuto:1000

Mensagens por hora:10.000

Webhooks por segundo:100

Headers de Resposta

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

Precisa de Ajuda?

Nossa equipe de desenvolvedores está pronta para ajudar você a integrar a Senger em seus projetos.

Suporte Técnico Ver Documentação