Documentação para Desenvolvedores

Envie mensagens do WhatsApp com uma API que você já conhece

Se você já chamou a API Meta WhatsApp Cloud, já conhece a nossa. Mesma estrutura, mesmo JSON, mesma autenticação Bearer.

01Início Rápido

Três coisas e sua primeira mensagem estará a caminho: a URL base, uma chave de dispositivo e o endpoint de mensagens.

Base URL

https://api.smartsybox.com

Authentication

Authorization: Bearer <YOUR_DEVICE_KEY>

Content type

application/json

O Endpoint

POST /v26.0/{phone-number-id}/messages

O segmento de versão é aceito em qualquer formato v — mantenha o que seu código atual usa.

02Envie sua primeira mensagem

Uma mensagem em texto simples. O corpo é o payload padrão da Cloud API.

cURL

curl -X POST https://api.smartsybox.com/v26.0/PHONE_NUMBER_ID/messages \
  -H "Authorization: Bearer YOUR_DEVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "15551234567",
    "type": "text",
    "text": { "body": "Hello from SyBox 👋" }
  }'

C# · HttpClient

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "YOUR_DEVICE_KEY");

string json = @"{
  ""messaging_product"": ""whatsapp"",
  ""to"": ""15551234567"",
  ""type"": ""text"",
  ""text"": { ""body"": ""Hello from SyBox"" }
}";

var res = await http.PostAsync(
    "https://api.smartsybox.com/v26.0/PHONE_NUMBER_ID/messages",
    new StringContent(json, Encoding.UTF8, "application/json"));

Console.WriteLine(await res.Content.ReadAsStringAsync());

A Resposta

Você recebe de volta exatamente o que a Meta retorna, com o mesmo status HTTP.

200 OK · application/json

{
  "messaging_product": "whatsapp",
  "contacts": [{ "input": "15551234567", "wa_id": "15551234567" }],
  "messages": [{ "id": "wamid.HBgLMTU1NTEyMzQ1NjcVAgARGBI…" }]
}

03Qualquer tipo de mensagem funciona

Como o corpo é encaminhado sem alterações, todos os tipos de mensagem da Cloud API são suportados.

Request body · template

{
  "messaging_product": "whatsapp",
  "to": "15551234567",
  "type": "template",
  "template": {
    "name": "hello_world",
    "language": { "code": "en_US" }
  }
}

04Mostre seus dados ao lado do chat

Quando um agente abre uma conversa, o SyBox chama SEU endpoint e exibe o que você retornar ao lado do chat.

Request · SyBox → your endpoint

POST YOUR_ERP_URL
Authorization: Bearer YOUR_ERP_KEY
X-Sybox-Action: lookup

# body: { "data": "<json string>" } — the decoded "data":
{
  "phone": "15551234567",
  "email": "customer@example.com",
  "ref": ""
}

Your reply · application/json

{
  "renderAs": "table",
  "content": [
    { "Order": "#10432", "Status": "Shipped", "Total": "1,250 MAD" }
  ]
}

renderAs

Defina renderAs para informar ao SyBox como exibir seu conteúdo:

table

Rows & columns. content = an array of flat objects (or { rows: [ … ] }). Object keys become the column headers.

cards · kpi

Compact tiles (a balance, an order count). content = an array of { label, value } (or { cards: [ … ] }).

feed · list · thread

A timeline of rich cards. content = an array of { title, text, date, tags, media:[{ type, url, name }] }.

message

A single message-style card (one record laid out as a note).

html

Your own trusted HTML — content = a string. Use only for markup you generate yourself.

sections

Several blocks at once: content = { sections: [ { title, renderAs, content } ] } — mix a table + cards + a feed in one reply.

json

The default when renderAs is omitted — SyBox pretty-prints your content as-is.

Adicione sybox_ref a qualquer linha de tabela para torná-la clicável.

Enviamos telefone e e-mail — responda com { renderAs, content }.

05Abra um chamado a partir do seu sistema

Seu sistema solicita ao SyBox a abertura de um registro unificado de atendimento.

cURL

curl -X POST "https://api.smartsybox.com/v1/case" \
  -H "Authorization: Bearer $SYBOX_CASE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_unique_id": "CUST-10432",
    "header": "Screen replacement not delivered",
    "description": "Paid on 12 Aug, promised in 3 days, still nothing.",
    "ext_ref": "TICKET-99817"
  }'

Os campos

customer_unique_id

Seu próprio ID de registro do cliente.

header / description

Pelo menos um é obrigatório. O cabeçalho é o que os atendentes veem na lista.

ext_ref

Seu número de chamado.

O cliente já deve existir no sistema.

Use uma chave do tipo 'case'.

06Envie mensagens de outro programa

Para qualquer canal externo: notas do PDV, alertas de dispositivos ou registros legados.

cURL

curl -X POST "https://api.smartsybox.com/v1/inbound" \
  -H "Authorization: Bearer $SYBOX_INBOUND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "212600112233",
    "text": "Order 4821 has left the warehouse."
  }'

Somente entrada por design. Esta rota escreve na conversa.

07Erros

Erros são retornados exatamente da Meta com os mesmos códigos de status.

4xx · application/json

{
  "error": {
    "message": "(#131030) Recipient phone number not in allowed list",
    "type": "OAuthException",
    "code": 131030
  }
}

08Obtendo uma chave de dispositivo

As chaves são criadas dentro do seu espaço de trabalho.

Abra seu espaço de trabalho → Configurações → Chaves de API.
Cada chave está vinculada a um número e pode ser revogada a qualquer momento.
Seu token real do WhatsApp nunca sai do nosso servidor.
O gateway vem desativado por padrão.

Marcas registradas e atribuição

O SyBox é um produto independente e não possui vínculo com a Meta Platforms, Inc.

Nosso gateway espelha a estrutura da API WhatsApp Cloud por compatibilidade.

Todos os direitos da API oficial do WhatsApp Cloud pertencem à Meta Platforms, Inc.

Início Recursos Sobre nós Política de Privacidade Termos de Serviço Política de Reembolso Exclusão de Dados Fale conosco

WhatsApp, Messenger, and Instagram are trademarks of Meta Platforms, Inc.
SyBox™ is an independent product built on Meta Cloud API.