iHelpAPI
Pegar meu token

POST/customers/add-new-call

Criar novo chat

Veja como criar novo chat, com parâmetros e exemplos de requisição e resposta na API do iHelp.

POSThttps://apiv3.ihelpchat.com/api/v2/customers/add-new-call

POST

https://apiv3.ihelpchat.com/api/v2/customers/add-new-call

O body é igual ao de `send-template`

O corpo do request é o mesmo nos dois endpoints. O que muda é o painel usado para gerenciar os templates: Gupshup ou Meta.

Onde vão os parâmetros

PainelcloudApiTemplateNameVariáveis de textoBotões de URL
GupshupID do template (UUID)paramsparams, sempre por último
MetaNome do templateparamsurlParams (campo separado)

Os valores seguem a ordem em que aparecem no template: primeiro as variáveis de texto, depois os botões de URL (da esquerda para a direita).

Veja Pegar ID do template para descobrir o valor de cloudApiTemplateName.

Painel Gupshup

Todos os parâmetros - de texto e de URL - vão dentro de params. Os de URL sempre no final da lista.

Texto simples, sem variáveis

Template sem variável nenhuma: não precisa de params.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Olá, estou iniciando seu atendimento no ihelp",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "2267be99-0000-4c2f-9a1b-9ee22e4841f8"
    },
    "nome": null,
    "atendimentoId": null
}

Texto com variáveis

Template com 2 variáveis de texto ({{1}} = nome, {{2}} = horário).

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Oi Gian, tudo bem? Confirmando nossa reunião de hoje às 10. Me responde com um 'sim' pra eu garantir seu lugar!",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "2267be99-0000-4c2f-9a1b-9ee22e4841f8",
        "params": ["Gian", "10"]
    },
    "nome": null,
    "atendimentoId": null
}

Com botões de resposta rápida

Botão de resposta rápida não tem parâmetro. Só as 2 variáveis de texto entram em params.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Oi Gian, tudo bem? Confirmando nossa reunião de hoje às 10. | [Sim] | [Reagendar]",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "2267be99-0000-4c2f-9a1b-9ee22e4841f8",
        "params": ["Gian", "10"]
    },
    "nome": null,
    "atendimentoId": null
}

O botão de URL não recebe o link inteiro

Quando o template é criado no painel da Gupshup, o começo da URL é fixo e fica salvo no próprio template. Só o final da URL é variável - e é só esse pedaço que você envia no request.

Início fixo, definido no painel ao criar o templatehttps://google.com/maps/
Trecho variável, enviado no request@-20.8175629,-49.3518848,14z
Link que o cliente recebehttps://google.com/maps/@-20.8175629,-49.3518848,14z

Mandar a URL completa duplica o prefixo e quebra o link.

Template sem variável de texto e com 1 botão de URL: params leva só o trecho variável da URL.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Seu pedido saiu para entrega. Acompanhe o trajeto pelo botão abaixo. | [Ver rota]",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "a86fd979-dc78-4f34-8931-fdb73f953cab",
        "params": ["@-20.8175629,-49.3518848,14z"]
    },
    "nome": null,
    "atendimentoId": null
}

Variáveis de texto + 1 botão de link dinâmico

Template com 3 variáveis de texto + 1 botão de URL. As 3 de texto vêm primeiro, o trecho da URL é o último item de params.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "⚠️ INFORMACAO DE VIAGEM\n\nCarga liberada\n\nPontos da Rota: Rio Preto / Mirassol\n\nRota: RT-4417\n\n[Navegação]",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "a86fd979-dc78-4f34-8931-fdb73f953cab",
        "params": [
            "Carga liberada",
            "Rio Preto / Mirassol",
            "RT-4417",
            "@-20.8175629,-49.3518848,14z"
        ]
    },
    "nome": null,
    "atendimentoId": null
}

Variáveis de texto + 2 botões de link dinâmico

Template com 2 variáveis de texto + 2 botões de URL. Os dois trechos de URL vão no final de params, na ordem dos botões.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Olá Gian, sua entrega RT-4417 está a caminho. | [Ver rota] | [Local de retirada]",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "a86fd979-dc78-4f34-8931-fdb73f953cab",
        "params": [
            "Gian",
            "RT-4417",
            "@-20.8175629,-49.3518848,14z",
            "@-20.8123456,-49.3499999,17z"
        ]
    },
    "nome": null,
    "atendimentoId": null
}

Painel Meta

As variáveis de texto ficam em params e os trechos de URL em urlParams, cada um na ordem dos botões. O cloudApiTemplateName é o nome do template.

Texto simples, sem variáveis

Template sem variável nenhuma: não precisa de params.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Olá, estou iniciando seu atendimento no ihelp",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "new_call"
    },
    "nome": null,
    "atendimentoId": null
}

Texto com variáveis

Template com 2 variáveis de texto ({{1}} = nome, {{2}} = horário).

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Oi Gian, tudo bem? Confirmando nossa reunião de hoje às 10. Me responde com um 'sim' pra eu garantir seu lugar!",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "lembrete_reuniao",
        "params": ["Gian", "10"]
    },
    "nome": null,
    "atendimentoId": null
}

Com botões de resposta rápida

Botão de resposta rápida não tem parâmetro. Só as 2 variáveis de texto entram em params.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Oi Gian, tudo bem? Confirmando nossa reunião de hoje às 10. | [Sim] | [Reagendar]",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "lembrete_reuniao",
        "params": ["Gian", "10"]
    },
    "nome": null,
    "atendimentoId": null
}

O botão de URL não recebe o link inteiro

Quando o template é criado no painel da Meta, o começo da URL é fixo e fica salvo no próprio template. Só o final da URL é variável - e é só esse pedaço que você envia no request.

Início fixo, definido no painel ao criar o templatehttps://google.com/maps/
Trecho variável, enviado no request@-20.8175629,-49.3518848,14z
Link que o cliente recebehttps://google.com/maps/@-20.8175629,-49.3518848,14z

Mandar a URL completa duplica o prefixo e quebra o link.

Template sem variável de texto e com 1 botão de URL: mande só urlParams e omita o params.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Seu pedido saiu para entrega. Acompanhe o trajeto pelo botão abaixo. | [Ver rota]",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "pedido_a_caminho",
        "urlParams": ["@-20.8175629,-49.3518848,14z"]
    },
    "nome": null,
    "atendimentoId": null
}

Variáveis de texto + 1 botão de link dinâmico

Template com 3 variáveis de texto + 1 botão de URL: as de texto em params, a da URL em urlParams.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "⚠️ INFORMACAO DE VIAGEM\n\nCarga liberada\n\nPontos da Rota: Rio Preto / Mirassol\n\nRota: RT-4417\n\n[Navegação]",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "informacao_viagem",
        "params": [
            "Carga liberada",
            "Rio Preto / Mirassol",
            "RT-4417"
        ],
        "urlParams": ["@-20.8175629,-49.3518848,14z"]
    },
    "nome": null,
    "atendimentoId": null
}

Variáveis de texto + 2 botões de link dinâmico

Template com 2 variáveis de texto + 2 botões de URL: urlParams leva um trecho por botão, na ordem em que aparecem no template.

{
    "contactList": ["5588882222"],
    "departamentoId": 6668,
    "canalId": 8181,
    "mensagemInicial": {
        "texto": "Olá Gian, sua entrega RT-4417 está a caminho. | [Ver rota] | [Local de retirada]",
        "tipoMensagem": 9,
        "cloudApiTemplateName": "entrega_a_caminho",
        "params": ["Gian", "RT-4417"],
        "urlParams": [
            "@-20.8175629,-49.3518848,14z",
            "@-20.8123456,-49.3499999,17z"
        ]
    },
    "nome": null,
    "atendimentoId": null
}

Atenção

  • 📞 Números devem estar no formato E.164: 55DD9XXXXXXXX
  • 🔗 Links só funcionam em botões do tipo URL Button
  • 🧪 Sempre teste templates no Meta Template Manager antes de usar em produção

Documentação atualizada: 2026-08-05

Continue lendo

TemplatesTemplates de mensagemTemplatesPegar ID do templateTemplatesRegras da Meta e logs de erro