Skip to main content
Uma integração é a conexão entre o Tivar e um canal de mensagem externo. Cada integração representa uma conta ou número ativo em um provedor específico — por exemplo, um número de WhatsApp Business ou uma conta do Telegram. Você pode ter múltiplas integrações do mesmo canal conectadas ao mesmo workspace.

​
Canais suportados

WhatsApp Oficial

Conecta via Meta Cloud API. Valor na API: "whatsapp-official". Suporta envio de mensagens de texto e templates HSM.

WhatsApp (UAZAPI)

Conecta via UAZAPI (WhatsApp não-oficial). Valor na API: "uazapi". Suporta envio de mensagens de texto.

Telegram

Conecta um bot do Telegram ao workspace. Valor na API: "telegram".

Instagram

Conecta a sua conta do Instagram para mensagens diretas. Valor na API: "instagram".

Messenger

Conecta o Facebook Messenger da sua página. Valor na API: "messenger".

Live Chat

Widget de chat ao vivo para seu site. Valor na API: "livechat".

Mercado Livre

Conecta as mensagens da sua conta do Mercado Livre. Valor na API: "mercado_livre".

​
Como conectar uma integração

1

Acesse as configurações de integrações

No painel do Tivar, vá para Configurações → Integrações.
2

Adicione uma nova integração

Clique em Adicionar integração e selecione o canal desejado.
3

Siga as instruções do canal

Cada canal tem seu próprio fluxo de autenticação. Siga os passos exibidos na tela para concluir a conexão.
4

Confirme o status 'conectada'

A integração deve aparecer com status conectada antes de ser usada em chamadas de API.

​
O integrationId

Cada integração possui um UUID único chamado integrationId. Você pode usá-lo nas chamadas de API para direcionar uma mensagem a uma integração específica quando tiver mais de uma do mesmo canal conectada ao workspace. 
{
  "phone": "5511999998888",
  "message": "Olá!",
  "channel": "whatsapp-official",
  "integrationId": "uuid-da-integracao-especifica"
}
O parâmetro integrationId é opcional. Se omitido, o Tivar usa automaticamente a integração conectada mais recente para o canal informado.

​
Status de conexão

A integração precisa estar com status conectada para que as chamadas de API funcionem. Se a integração estiver desconectada, a API retorna: 
{
  "error": "Integração não está conectada"
}
Se você receber o erro 400 "Integração não está conectada", acesse Configurações → Integrações no painel e reconecte a integração afetada antes de tentar novamente.
Se nenhuma integração do canal especificado existir no workspace, a API retorna 404 com a mensagem indicando o canal ausente (ex.: "Nenhuma integração \"whatsapp-official\" conectada neste workspace").

​
O campo integration.provider nos webhooks

Os payloads de webhook incluem um objeto integration com o campo provider, que identifica o canal da integração que originou o evento: 
{
  "integration": {
    "id": "uuid-da-integracao",
    "provider": "whatsapp-official"
  }
}
Os valores possíveis de provider são: whatsapp-official, whatsapp, telegram, instagram, messenger, livechat, mercado_livre.
Use o campo integration.provider nos seus webhooks para aplicar lógica diferente por canal — por exemplo, responder de forma distinta a mensagens do WhatsApp e do Mercado Livre em um mesmo fluxo de automação.