hubling.ai
  1. Communication
hubling.ai
  • API (v1)
    • Communication
      • Create communication
        POST
      • List communications
        GET
      • Get communication
        GET
  1. Communication

Create communication

Em desenvolvimento
POST
https://api.hubling.ai/api/v1/communications
Última modificação:2026-01-18 14:38:02
Responsável:Thiago Moraes
Este endpoint é utilizado para realizar o disparo em massa de comunicações via WhatsApp. Ele permite enviar mensagens para uma lista de contatos utilizando templates pré-aprovados na Meta.
Principais funcionalidades:
Mapeamento Dinâmico: Use a sintaxe %contact.nome_do_campo% nas variáveis do template para personalizar a mensagem com dados específicos de cada contato (ex: nome, email ou campos customizados dentro de metadata).
Flexibilidade de Variáveis: Aceita o mapeamento tanto por posição (Array) quanto por chave (Objeto).
Agendamento: Através do campo scheduledAt, você pode programar o disparo para uma data e hora futura.
Gestão de Contatos: O sistema realiza automaticamente o cadastro ou atualização (upsert) dos contatos enviados no disparo.

Requisição

Authorization
Adicionar parâmetro em header
x-api-key
Exemplo:
x-api-key: ********************
Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.hubling.ai/api/v1/communications' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "assistantId": "c5531a4e-757b-45cb-83cc-32e13b520ac9",
  "from": "558005452025",
  "name": "Campanha Promocional",
  "template": {
    "name": "comunicado_inicial",
    "variables": [
      "Olá %contact.name%!",
      "Sua oferta de %contact.metadata.desconto% acaba hoje."
    ]
  },
  "contacts": [
    {
      "phone": "5511988888888",
      "name": "Thiago",
      "metadata": { "desconto": "20%" }
    }
  ]
}'
Response Response Example
{
    "message": "string",
    "id": "string",
    "status": "scheduled",
    "totalContacts": 0,
    "scheduledAt": "2019-08-24T14:15:22.123Z"
}
Modificado em 2026-01-18 14:38:02
Próxima página
List communications
Built with